前言¶
交付或內審前，團隊往往要補齊需求規格、設計說明、API 說明、測試與部署類文檔。這些材料若全靠人工從代碼裏反推，耗時長，格式也容易前後不一致。下面介紹 SkillHub 上的社區 Skill「項目文檔生成專家」：在 Agent 對話裏觸發後，由 Skill 引導自動分析當前項目代碼，並按固定模板生成多套文檔，並支持版本管理。
這是什麼¶
「項目文檔生成專家」是 SkillHub 社區來源（community）的 Agent Skill，座標爲 @user_dd91c74f/project-doc-generator，當前頁面版本爲 v1.0.3，發佈者爲 user_dd91c74f，分類爲 dev-programming。頁面標註 requires_api_key=false，安裝與使用不依賴額外 API Key。
它面向「已有代碼、缺成套項目文檔」的場景：用自然語言觸發 Skill，讓 Agent 按 Skill 內定義的流程分析倉庫並落盤文檔，而不是從零手寫每一章。
官方頁面：
- SkillHub：https://www.skillhub.cn/skills/user_dd91c74f/project-doc-generator
- API 入口：https://api.skillhub.cn/user_dd91c74f/project-doc-generator
核心功能¶
依據官方簡介與 SkillHub 頁面，已覈實的能力如下。
- 代碼分析：自動分析項目代碼（具體掃描範圍與深度由 Skill 內
SKILL.md及 Agent 執行環境決定）。 - 七套標準文檔：一次流程可生成下列文檔類型——需求規格、概要設計、詳細設計、數據庫設計、API 文檔、測試計劃、部署手冊與用戶手冊。
- 版本管理：支持對生成結果做版本管理（具體目錄命名與增量規則以安裝後的 Skill 說明爲準）。
- 觸發短語：當用戶說「形成項目文檔」或「生成項目文檔」時，Agent 應調用該 Skill（官方簡介中的 Invoke 說明）。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式，需安裝到當前 Agent 能識別的 skills 目錄；裝錯目錄會導致 Agent 無法加載。
方式一：SkillHub CLI¶
先確認是否已安裝 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝本 Skill 時必須使用 --dir 指向當前環境的 skills 目錄。官方安裝說明中的常用路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例（將 <skills 目錄> 換成上面對應路徑）：
skillhub install @user_dd91c74f/project-doc-generator --dir <skills 目錄>
安裝後若 Agent 未立即識別新 Skill，按所用客戶端說明重啓或刷新會話。
方式二：讓 Agent 按官方指引安裝¶
SkillHub 頁面提供的安裝提示爲：讓 AI 根據 https://skillhub.cn/install/skillhub.md 安裝 @user_dd91c74f/project-doc-generator。在 Cursor 等支持 Skills 的客戶端中，可將該句直接發給 Agent，由 Agent 讀取安裝文檔並執行 skillhub install 與目錄配置。
典型用法¶
- 在已打開目標項目的工作區中啓用該 Skill（完成上一節安裝）。
- 在對話中說明意圖，使用官方觸發語之一，例如：
- 「生成項目文檔」
- 「形成項目文檔」 - 按 Agent 提示確認分析範圍（模塊、分支、是否覆蓋數據庫與 API 等），等待其根據代碼生成七類文檔並寫入約定輸出位置。
- 若需保留多輪迭代結果，利用 Skill 聲明的版本管理能力區分各次生成（具體以 Skill 內文檔爲準）。
官方未提供獨立命令行「一鍵出 doc」示例；可復現路徑是：安裝 Skill → 在項目上下文中用觸發語發起任務。
適用場景與注意¶
適合誰
- 需要快速補齊立項、驗收或協作所需的規範文檔，且倉庫結構相對清晰的後端、全棧或帶 API 的項目。
- 已在 Cursor、Claude Code、Codex 等支持 SkillHub skills 目錄的 Agent 環境中工作的開發者。
使用上需注意
- 生成內容質量取決於代碼可讀性、註釋與項目規模；複雜業務規則仍需人工校對，不宜未經審覈直接作爲正式交付物。
skillhub install必須指定正確的--dir，否則默認裝到./skills/可能不被當前 Agent 加載。- 社區來源 Skill，升級與行爲變更以 SkillHub 上 v1.0.3 及後續版本爲準；安裝前可在頁面查看評分與下載量（頁面展示爲評分 100000、下載 5403，數據隨 SkillHub 更新而變化）。
結尾¶
「項目文檔生成專家」把「從代碼反推文檔」收成可重複的 Agent 工作流：七類標準文檔加版本管理，用「生成項目文檔」或「形成項目文檔」即可喚起。安裝與優先源配置以 SkillHub 文檔爲準：https://skillhub.cn/install/skillhub.md ；Skill 詳情頁：https://www.skillhub.cn/skills/user_dd91c74f/project-doc-generator 。
