ai-dev-studio

将 PRD、技术架构、UI 设计三份文档整合为 AI 编程工具可以一步步执行的开发任务序列。当用户运行 ~plan 指令时必须立即调用此技能；当用户说到「任务拆解」「开发规划」「AI 开发指令」「开发顺序」「执行计划」时也要主动触发。产出 docs/dev-tasks.md，每个任务必须包含：任务目标、前置依赖（T 编号）、涉及文件、具体要求（引用 F/P 编号）、验证方式（小白可操作）、边缘情况（2-3 条重点测试提示）。任务粒度原则是「每个任务完成后用户能看到可验证的结果」，AI 执行时间控制在 5-20 分钟。文档末尾必须包含 6 条 Claude Code 行为规范（中文回复、先描述方案、需求澄清、禁止兼容补丁、列边缘情况、BUG 先定位），供用户在第一次执行时发给 AI。在开始工作前必须先完成对上游三份文档的前置审查。

在用户拿到开发文档包后、实际用 Claude Code 开发过程中提供辅助。当用户运行 ~debug、~verify、~skip 指令时必须调用此技能；当用户说到「执行不下去」「报错」「验证任务」「跳过任务」「卡住了」「下一步怎么办」时也要主动触发。负责读取 docs/dev-tasks.md 中指定任务的上下文，判断问题是任务拆解的问题还是执行的问题，给出针对性建议；协助用户按验证方式和边缘情况逐项测试；评估跳过任务对下游的影响。这是整条流水线真正把小白送达「产品做出来」的关键一环，弥补了从文档包到可运行产品之间的断层。

通过多轮引导式对话帮用户把模糊的产品想法梳理成结构化的产品需求文档（PRD）。当用户运行 ~analyze 指令时必须立即调用此技能；当用户说到「需求分析」「功能梳理」「PRD」「产品需求文档」「整理功能清单」「理清想法」「定义功能」时也要主动触发。产出标准化的 docs/prd.md 文件，使用 M001 / F001-01 格式的模块和功能编号，供下游的技术架构师、UI 设计师、开发规划师引用。面向完全不懂技术的小白用户，用日常语言提问，不使用技术术语。在开始工作前必须先完成对 project-config.md 的前置审查，发现模糊或缺失立即向产品经理报告。

在每个阶段产出后进行质量审核，包括完整性、清晰性、一致性、可执行性四个维度的评分，以及仿真测试和结构化对账两种深度检查。当任何阶段的文档产出完成后必须立即自动触发此技能；当用户运行 ~review 指令查看审核详情时也要触发；当用户说到「审核」「检查文档」「质量把关」「对账」时也要主动触发。审核不通过（平均分 < 8 分或任一项 < 6 分）自动打回对应角色修改，最多 3 轮迭代。除了打分以外，必须执行「仿真测试」——自己扮演下游角色，验证文档是否真的足以支撑下游工作；必须执行「结构化对账」——把 PRD 功能编号与技术架构 API 接口、数据字段做表格化比对，检查遗漏。审核报告写入 docs/review-{阶段}.md，供 ~review 指令调阅。

根据产品需求文档（PRD）做技术选型、数据库设计、API 规划和环境配置方案。当用户运行 ~architect 指令时必须立即调用此技能；当用户说到「技术架构」「技术选型」「数据库设计」「API 设计」「架构方案」时也要主动触发。基于多维度决策框架做真正的工程判断，而不是机械匹配模板——技术选型必须考虑用户规模、数据量、并发需求、实时性、团队熟悉度等因素。产出 docs/tech-architecture.md，所有数据表和 API 接口必须标注对应的 PRD 功能编号（F001-01 格式），形成可追溯的设计链路。面向不懂技术的小白用户，每个决策都用大白话解释原因。在开始工作前必须先完成对 PRD 的前置审查。

根据产品需求文档和技术架构，为每个页面设计界面布局、组件构成、交互流程和导航结构。当用户运行 ~design 指令时必须立即调用此技能；当用户说到「界面设计」「UI 设计」「页面规划」「交互流程」「布局设计」时也要主动触发。不生成设计图片，而是用 ASCII 布局图 + 结构化文字精确描述每个页面长什么样、用户怎么操作——这种形式 AI 编程工具能直接理解并生成代码。对核心页面（如首页、仪表盘）必须并行生成 2-3 个差异化方案让用户选择，而不是直接给出单一方案。产出 docs/ui-design.md，所有页面使用 P001 格式编号，可交互元素引用 PRD 功能编号。在开始工作前必须先完成对 PRD 和技术架构的前置审查。