前言¶
產品需求文檔（PRD）寫完後，團隊往往還要再補一份「設計方案」：模塊劃分、接口約定、數據結構、實現要點等。若完全靠人工從 PRD 裏二次整理，格式容易各寫各的，後續給開發、評審或自動化流水線用時也不統一。
下面介紹 SkillHub 上的社區 Skill「設計方案」（座標 @user_ad708a9f/phase-design，當前版本 v1.0.0）。它的定位很明確：以 PRD 爲輸入，產出標準化設計方案，並支持 Markdown、JSON、YAML 三種輸出，方便不同下游直接接入。
這是什麼¶
「設計方案」是 SkillHub 社區用戶 user_ad708a9f 發佈的開發類 Skill，分類爲 dev-programming，來源標註爲 community。官方頁面說明其能力爲：將 PRD 文檔轉化爲標準化設計方案，輸出三種格式（MD/JSON/YAML）供下游使用。頁面標籤標明 requires_api_key=false，即按 SkillHub 展示信息，不依賴額外 API Key。
Skill 基於通用 SKILL.md 格式，通過 Agent 讀取技能說明後在對話中執行，而不是單獨的可執行 CLI 工具。
核心功能¶
結合 SkillHub 已公開文案，可覈實的能力如下：
- 輸入：PRD 類需求文檔（正文、附件或對話中粘貼的等價內容，具體字段與檢查項以技能包內
SKILL.md爲準）。 - 處理：將 PRD 信息整理爲「標準化設計方案」結構，減少人工從需求到設計文檔的重複勞動。
- 輸出：同一套設計內容可導出爲 MD（便於評審與歸檔）、JSON（便於程序解析）、YAML（便於配置與流水線）三種格式，供下游工具或後續 Skill 使用。
SkillHub 頁面當前統計（以頁面與抓取元數據爲準）：評分 100000，下載約 3902 次，安裝約 18 次。數據會隨時間變化，以 SkillHub 詳情頁 爲準。
安裝與啓用¶
安裝流程遵循 SkillHub 官方文檔 SkillHub 安裝與優先源配置。官方頁面給出的安裝提示爲：根據該文檔安裝 @user_ad708a9f/phase-design。
1. 檢查或安裝 skillhub CLI¶
先確認本機是否已有 CLI：
command -v skillhub && skillhub --version
若未安裝，可使用官方推薦的一鍵安裝（含 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
2. 安裝到當前 Agent 的 skills 目錄¶
官方文檔強調：安裝時必須用 --dir 指向當前 Agent 實際使用的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。
常用路徑示例（摘自官方安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
在已安裝 CLI 的前提下，將技能裝到對應目錄（將 <skills 目錄> 換成你環境的路徑）：
skillhub install user_ad708a9f/phase-design --dir <skills 目錄>
也可在支持 Skill 的客戶端中，將官方頁面提示發送給 AI，讓其按 skillhub.md 完成安裝。
安裝後按你所用客戶端的要求刷新或重啓 Agent，使新 Skill 被加載。
典型用法¶
公開資料未附帶完整端到端示例腳本，可復現的流程可按「啓用 Skill → 提供 PRD → 指定輸出格式」理解：
- 在 Cursor、Claude Code 等已配置 skills 目錄的客戶端中確認「設計方案」已加載。
- 在對話中提供 PRD 全文或關鍵章節（背景、功能列表、非功能需求、約束等），並說明需要生成標準化設計方案。
- 按需指定輸出爲 MD、JSON 或 YAML 之一；若下游有固定 schema，可在對話中說明，由 Agent 按
SKILL.md中的規範組織字段。 - 將生成結果保存到倉庫或交給後續流水線；需要多格式時，可要求在同一份設計內容上分別輸出三種格式。
具體章節模板、必填項與校驗規則以安裝後的技能包內 SKILL.md 爲準，本文不展開未在官方簡介中出現的字段名。
適用場景與注意¶
適合誰
- 需要頻繁從 PRD 沉澱設計文檔的產品、架構或 Tech Lead。
- 希望設計產物同時給人看（MD）又給工具讀（JSON/YAML）的團隊。
- 已在使用 SkillHub / 支持
SKILL.md的編碼 Agent，希望把「PRD → 設計」固化爲可重複技能的同學。
注意
- 輸出質量依賴 PRD 的完整度與 Agent 對技能說明的遵循程度；複雜系統仍建議人工評審設計稿。
- 社區 Skill，維護節奏以發佈者
user_ad708a9f與 SkillHub 版本記錄爲準；升級可用skillhub在對應--dir下更新（參見官方安裝文檔）。 - 未覈實到該 Skill 需要 API Key；若你本地策略要求審計第三方 Skill，安裝前可在 SkillHub 查看技能包說明與權限。
結尾¶
「設計方案」把 PRD 到標準化設計文檔這一步收進 Agent Skill，並用 MD/JSON/YAML 三種格式對接不同下游。若你要從 SkillHub 安裝或查看版本信息，可使用：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_ad708a9f/phase-design
- 官方座標入口：https://api.skillhub.cn/user_ad708a9f/phase-design
