前言¶

产品需求文档（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 已公开文案，可核实的能力如下：

1. 输入：PRD 类需求文档（正文、附件或对话中粘贴的等价内容，具体字段与检查项以技能包内 SKILL.md 为准）。
2. 处理：将 PRD 信息整理为「标准化设计方案」结构，减少人工从需求到设计文档的重复劳动。
3. 输出：同一套设计内容可导出为 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 → 指定输出格式」理解：

1. 在 Cursor、Claude Code 等已配置 skills 目录的客户端中确认「设计方案」已加载。
2. 在对话中提供 PRD 全文或关键章节（背景、功能列表、非功能需求、约束等），并说明需要生成标准化设计方案。
3. 按需指定输出为 MD、JSON 或 YAML 之一；若下游有固定 schema，可在对话中说明，由 Agent 按 SKILL.md 中的规范组织字段。
4. 将生成结果保存到仓库或交给后续流水线；需要多格式时，可要求在同一份设计内容上分别输出三种格式。

具体章节模板、必填项与校验规则以安装后的技能包内 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