- name
- spec-coding
- description
- 规格驱动编程工作流。根据用户需求生成 Spec 文档（功能/API/组件），或为现有代码逆向生成规格文档。使用场景：(1) 新项目启动时先写规格，(2) 老项目补规格文档，(3) 需求评审时生成规格草稿，(4) 代码审查时对照规格验收。
Spec Coding 规格驱动编程
核心工作流
场景 1：新项目生成规格文档
当用户提出新需求时：
- 判断规格类型
- 功能需求 → 使用 feature-spec.md 模板 - API 接口 → 使用 api-spec.md 模板 - UI 组件 → 使用 component-spec.md 模板
- 生成规格草稿
- 读取对应模板（见 assets/templates/） - 根据用户需求填充各章节 - 重点明确：输入/输出规格、边界情况、验收标准
- 输出格式
# [功能名称] 规格文档
**状态**: `draft`
**创建日期**: YYYY-MM-DD
[完整规格内容]- 后续流程
- 用户评审 → 修改 → 批准 - 状态改为 approved 后交付开发 - 开发完成后对照规格验收
场景 2：老项目逆向生成规格
当用户需要为现有代码补规格文档时：
- 读取源代码
- 功能代码 → 分析输入/输出/行为 - API 代码 → 提取路由/参数/响应格式 - 组件代码 → 分析 Props/状态/交互
- 生成规格文档
- 对照模板填充已知信息 - 标注「待确认」章节（需要用户补充） - 输出 review 状态文档
- 输出示例
## 2.1 输入规格（已分析代码得出）
| 输入项 | 类型 | 必填 | 约束条件 |
|--------|------|------|----------|
| userId | string | 是 | UUID 格式 |
## 1.1 问题描述（待用户补充）
> ⚠️ 待确认：这个功能要解决什么问题？模板使用说明
读取模板文件前，先判断需求类型：
| 模板文件 | 适用场景 |
|---|---|
assets/templates/feature-spec.md | 业务功能、用户故事 |
assets/templates/api-spec.md | REST API、GraphQL、Webhook |
assets/templates/component-spec.md | React/Vue 组件、UI 控件 |
规格状态流转
draft → review → approved → in-progress → donedraft: 草稿，待用户补充信息review: 待评审，等待用户确认approved: 已批准，可交付开发in-progress: 开发中done: 已完成验收
输出原则
- 结构化优先 - 使用表格、代码块、列表
- 明确边界 - 必须列出所有边界情况和错误处理
- 可验收 - 每条规格都可被验证（是/否）
- 简洁 - 避免冗长描述，用示例代替解释
与子代理协作
- 研究员: 搜集竞品规格、行业标准
- 文案师: 润色用户提示文案、错误消息
- 落地执行: 根据规格实现代码、编写测试
参考文档
- 详细模板说明：
assets/templates/README.md - 规格示例：
assets/examples/