前言¶
接手陌生倉庫或做安全巡檢時，往往要先弄清「目錄怎麼擺、關鍵文件在哪」。手工 tree、find 可以完成掃描，但交給 Agent 時，若沒有統一步驟，容易漏目錄、重複掃 node_modules，或把猜測當成結論。
下面介紹 SkillHub 社區技能「分析文件目錄結構」（座標 @user_19fd2d55/analysis-project-content）。它屬於 it-ops-security 分類，發佈者爲 user_19fd2d55，當前版本 1.0.1，來源標註爲 community，且 不需要 API Key（requires_api_key=false）。技能包遵循通用 SKILL.md 格式，安裝後由 Agent 按技能內說明執行目錄與項目內容相關的分析流程。
這是什麼¶
「分析文件目錄結構」是掛在 SkillHub 上的一條 Agent Skill，用於在對話式環境中規範「看目錄、理結構」類任務。公開頁面上未附帶長文簡介，但從技能名稱與 slug analysis-project-content 可以確認：定位與項目文件目錄結構及項目內容層面的梳理相關，而不是單一語言的代碼補全或部署腳本。
維護與分發渠道爲 SkillHub 技能頁；元數據接口地址爲 https://api.skillhub.cn/user_19fd2d55/analysis-project-content（瀏覽器直接訪問可能非 GET 場景，以 SkillHub 頁面爲準）。
核心功能（以公開元數據爲準）¶
已能覈對的能力邊界如下，不展開未在官方渠道出現的具體命令或檢查清單：
- 目錄結構分析導向：技能名與分類（
it-ops-security）表明，適用於運維、安全或接手項目時需要先建立「目錄地圖」的場景。 - 無額外密鑰：標籤標明
requires_api_key=false，安裝後一般無需再配置第三方 API Key 即可按 SKILL.md 使用（若技能內引用本地 CLI，仍以 SKILL.md 爲準）。 - 標準 Skill 包形態：與其它 SkillHub 技能一樣，以
SKILL.md爲入口，由 Agent 在匹配任務時加載說明並執行。
官方頁面未公開完整 SKILL.md 正文；具體步驟、輸出模板、是否包含忽略規則（如 node_modules）等，需在安裝成功後閱讀本地技能目錄中的 SKILL.md。
安裝與啓用¶
SkillHub 推薦通過 安裝說明文檔 配置 CLI，並將包裝到當前 Agent 的 skills 目錄（否則默認落在 ./skills/，Agent 可能識別不到）。
1. 檢查或安裝 skillhub CLI¶
command -v skillhub && skillhub --version
若未安裝，可按官方文檔執行完整安裝（含默認 Skill）或僅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝本技能¶
安裝時必須用 --dir 指向當前環境的 skills 目錄。SkillHub 文檔給出的常見路徑包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例（將目錄換成你實際使用的 Agent 路徑）：
skillhub install user_19fd2d55/analysis-project-content --dir ~/.cursor/skills/
SkillHub 技能頁提供的「發給 AI 的安裝提示」爲：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_19fd2d55/analysis-project-content`。
也可將上述提示直接交給 Cursor 等 Agent，由其按文檔完成安裝。
3. 安裝後¶
按各 Agent 要求重啓或重新加載 skills 後，在對話中提出與「分析某項目目錄結構」相關的需求，Agent 應在命中技能描述時加載該 Skill。
注意：在部分環境中執行 skillhub install user_19fd2d55/analysis-project-content 時，若下載地址返回 HTTP 404，說明索引或包暫不可用，需先在 技能頁 確認是否仍可下載，或聯繫 SkillHub / 發佈者，避免文章中的命令與當時倉庫狀態不一致。
典型用法¶
公開資料未給出可複製粘貼的端到端對話示例。可復現的安裝側用法只有兩類：
- CLI 安裝（見上一節
skillhub install ... --dir ...）。 - 提示詞安裝：把技能頁上的安裝提示發給 Agent，並指明目標 skills 目錄（例如 Cursor 使用
~/.cursor/skills/）。
業務側典型用法應在安裝後打開技能包內的 SKILL.md，按其中的觸發條件與步驟操作；在未能成功下載包之前，不宜臆造「應先 tree 幾層、再輸出何種表格」等細節。
適用場景與注意¶
適合誰
- 需要 Agent 在接手倉庫、巡檢或文檔化之前，先系統化查看目錄與項目內容佈局的開發者與運維 / 安全相關角色。
- 已使用 SkillHub 生態、希望在多 Agent 間用同一座標複用技能的用戶。
限制與注意
- 社區來源（
community）：質量與更新節奏依賴發佈者user_19fd2d55，使用前建議閱讀SKILL.md與版本號（當前 1.0.1）。 - 統計口徑：SkillHub 抓取元數據顯示評分 100000、下載 970、安裝 2；頁面展示可能隨時間變化，以安裝時 SkillHub 爲準。
- 下載可用性：若 CLI 安裝失敗，應優先排查包是否下線，而不是反覆更換未文檔化的鏡像地址。
- 範圍：目錄結構分析不能替代代碼審計、依賴漏洞掃描或權限模型驗證；技能若未寫明安全檢測項，不應默認具備這些能力。
結尾¶
「分析文件目錄結構」把「看清項目目錄與內容佈局」收攏爲一條可安裝的 Agent Skill：座標 @user_19fd2d55/analysis-project-content，版本 1.0.1，免 API Key，歸類在 it-ops-security。先做 CLI 或提示詞安裝到正確的 skills 目錄，再在本地 SKILL.md 中落實具體步驟，即可在 Cursor 等客戶端中複用。
官方入口：https://www.skillhub.cn/skills/user_19fd2d55/analysis-project-content
