前言¶
PRD 写清楚「要什么」，开发还需要一份技术设计：接口怎么扩、表要不要改、和现有模块怎么接。手工从 PRD 抄要点再对照仓库翻代码，往往耗在对齐存量实现和规范格式上。下面介绍 SkillHub 上的社区 Skill「根据prd生成设计方案」，它在解读 PRD 的同时扫描当前项目代码，按统一流程输出技术设计文档，并对模糊点做显式标注。
这是什么¶
「根据prd生成设计方案」是 SkillHub 社区发布者 user_df16bbeb 维护的 Agent Skill（坐标 @user_df16bbeb/prd-to-tech-design，当前版本 1.0.7，分类 dev-programming）。定位一句话：根据 PRD 文档，结合存量项目代码，生成技术设计文档。标签 requires_api_key=false，不依赖额外 API Key。
- 官方资源页：https://api.skillhub.cn/user_df16bbeb/prd-to-tech-design
- SkillHub 展示页：https://www.skillhub.cn/skills/user_df16bbeb/prd-to-tech-design
核心功能¶
以下能力与官方页面、已抓取资料一致，按执行顺序理解即可。
- 解读 PRD：提取核心需求、边界条件、异常场景。
- 代码分析：扫描存量代码，识别技术栈、公共组件、已有接口与表结构。
- 文档生成：输出符合项目规范的技术设计文档（具体章节以 Skill 内
SKILL.md约定为准）。 - 风险标注：对模糊点、冲突点标注「需人工确认」。
- 设计自检：生成后做一致性、完整性、可行性检查。
Skill 说明中强调：在相关场景应主动调用，即使用户只提供部分 PRD 内容也应触发。
安装与启用¶
Skill 基于通用 SKILL.md 格式，可通过 SkillHub 安装指引装入当前 Agent 的 skills 目录。
方式一：让 Agent 按官方指引安装¶
将下面提示发给支持 Skill 的 AI（Cursor、Claude Code、Codex CLI 等），由 Agent 读取安装文档并完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_df16bbeb/prd-to-tech-design`。
方式二：使用 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令形态（将 <skills 目录> 换成实际路径）：
skillhub install @user_df16bbeb/prd-to-tech-design --dir <skills 目录>
具体子命令以当前 skillhub 版本为准；也可先用 skillhub search prd-to-tech-design 核对包名后再 install。
典型用法¶
本 Skill 没有单独的长示例仓库，用法由触发场景驱动。在已安装并启用后，可按下面步骤复现工作流。
- 打开目标业务仓库（或把 PRD 与代码放在 Agent 可访问的工作区内）。
- 提供 PRD：粘贴正文、附上文档链接，或口述「根据这个 PRD 生成技术设计文档」。
- 明确期望：例如「生成技术方案」「帮我写 tech design」「设计接口」，或问「这份需求如何实现」。
- Agent 按 Skill 流程解读 PRD、分析代码、生成设计文档，并对不确定项标「需人工确认」。
- 人工过一遍标注项与自检结果，再进入开发与评审。
示例提示（可按项目改写）：
这是本期 PRD（见附件/链接）。请结合当前仓库代码，生成技术设计文档，接口与数据变更要对齐现有实现。
即使 PRD 只有部分章节，也可先触发 Skill，由生成结果中的「需人工确认」项补齐缺口。
适用场景与注意¶
适合谁
- 要把 PRD 转成可评审、可拆任务的详细设计，且设计必须贴合现有代码库的团队。
- 需要在设计阶段就暴露需求与存量实现冲突、边界未写清的情况。
触发话术（官方列举）
- 「根据这个 PRD 生成技术设计文档」
- 提供 PRD 链接或内容并要求生成技术设计
- 「帮我写 tech design」「生成技术方案」「设计接口」
- 需要将 PRD 转为可开发的详细设计文档
- 粘贴需求文档并询问如何实现
使用注意
- 代码可见性：「代码分析」依赖 Agent 能读取目标仓库；仅有 PRD、没有代码上下文时，设计会更偏假设，需更多人工确认。
- 规范来源：「符合项目规范」以仓库内既有文档、目录约定及 Skill 指令为准；若团队有固定设计模板，可在提示中一并说明。
- 人工把关：风险标注与自检不能替代评审；标为「需人工确认」的条目应在开发前闭合。
- 社区 Skill：来源为 community，版本与下载量以 SkillHub 为准（页面统计示例：评分 100000，下载 622；安装数 0 仅表示页面展示字段，不代表不可用）。
结尾¶
「根据prd生成设计方案」把 PRD 解读、存量代码对照、设计文档输出和自检串成一条链路，适合从需求直接进入技术方案阶段的日常开发。安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_df16bbeb/prd-to-tech-design ，资源坐标：https://api.skillhub.cn/user_df16bbeb/prd-to-tech-design 。
