{"skill":{"slug":"spec-coding","displayName":"Spec Coding","summary":"规格驱动编程工作流。根据用户需求生成 Spec 文档（功能/API/组件），或为现有代码逆向生成规格文档。使用场景：(1) 新项目启动时先写规格，(2) 老项目补规格文档，(3) 需求评审时生成规格草稿，(4) 代码审查时对照规格验收。","description":"---\nname: spec-coding\ndescription: 规格驱动编程工作流。根据用户需求生成 Spec 文档（功能/API/组件），或为现有代码逆向生成规格文档。使用场景：(1) 新项目启动时先写规格，(2) 老项目补规格文档，(3) 需求评审时生成规格草稿，(4) 代码审查时对照规格验收。\n---\n\n# Spec Coding 规格驱动编程\n\n## 核心工作流\n\n### 场景 1：新项目生成规格文档\n\n当用户提出新需求时：\n\n1. **判断规格类型**\n   - 功能需求 → 使用 `feature-spec.md` 模板\n   - API 接口 → 使用 `api-spec.md` 模板\n   - UI 组件 → 使用 `component-spec.md` 模板\n\n2. **生成规格草稿**\n   - 读取对应模板（见 `assets/templates/`）\n   - 根据用户需求填充各章节\n   - 重点明确：输入/输出规格、边界情况、验收标准\n\n3. **输出格式**\n   ```markdown\n   # [功能名称] 规格文档\n   \n   **状态**: `draft`\n   **创建日期**: YYYY-MM-DD\n   \n   [完整规格内容]\n   ```\n\n4. **后续流程**\n   - 用户评审 → 修改 → 批准\n   - 状态改为 `approved` 后交付开发\n   - 开发完成后对照规格验收\n\n### 场景 2：老项目逆向生成规格\n\n当用户需要为现有代码补规格文档时：\n\n1. **读取源代码**\n   - 功能代码 → 分析输入/输出/行为\n   - API 代码 → 提取路由/参数/响应格式\n   - 组件代码 → 分析 Props/状态/交互\n\n2. **生成规格文档**\n   - 对照模板填充已知信息\n   - 标注「待确认」章节（需要用户补充）\n   - 输出 `review` 状态文档\n\n3. **输出示例**\n   ```markdown\n   ## 2.1 输入规格（已分析代码得出）\n   \n   | 输入项 | 类型 | 必填 | 约束条件 |\n   |--------|------|------|----------|\n   | userId | string | 是 | UUID 格式 |\n   \n   ## 1.1 问题描述（待用户补充）\n   > ⚠️ 待确认：这个功能要解决什么问题？\n   ```\n\n## 模板使用说明\n\n读取模板文件前，先判断需求类型：\n\n| 模板文件 | 适用场景 |\n|----------|----------|\n| `assets/templates/feature-spec.md` | 业务功能、用户故事 |\n| `assets/templates/api-spec.md` | REST API、GraphQL、Webhook |\n| `assets/templates/component-spec.md` | React/Vue 组件、UI 控件 |\n\n## 规格状态流转\n\n```\ndraft → review → approved → in-progress → done\n```\n\n- `draft`: 草稿，待用户补充信息\n- `review`: 待评审，等待用户确认\n- `approved`: 已批准，可交付开发\n- `in-progress`: 开发中\n- `done`: 已完成验收\n\n## 输出原则\n\n1. **结构化优先** - 使用表格、代码块、列表\n2. **明确边界** - 必须列出所有边界情况和错误处理\n3. **可验收** - 每条规格都可被验证（是/否）\n4. **简洁** - 避免冗长描述，用示例代替解释\n\n## 与子代理协作\n\n- **研究员**: 搜集竞品规格、行业标准\n- **文案师**: 润色用户提示文案、错误消息\n- **落地执行**: 根据规格实现代码、编写测试\n\n## 参考文档\n\n- 详细模板说明：`assets/templates/README.md`\n- 规格示例：`assets/examples/`\n","topics":["Coding","编程","代码审查","工作流","文档"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":641,"installsAllTime":24,"installsCurrent":1,"stars":0,"versions":1},"createdAt":1773509671119,"updatedAt":1778491910241},"latestVersion":{"version":"1.0.0","createdAt":1773509671119,"changelog":"- Initial release of spec-coding skill.\n- Supports generating structured spec documents (feature, API, component) based on user requirements or existing codebase.\n- Provides scenario-based workflows for both new project specification and reverse-engineering specs for legacy code.\n- Includes detailed status flow (draft, review, approved, etc.) and usage guidelines for templates.\n- Designed for collaboration with researcher, copywriter, and implementation sub-agents.","license":"MIT-0"},"metadata":null,"owner":{"handle":"pupuking723","userId":"s179ebgrc03hvmrv3med8fp4v988487e","displayName":"pupuking723","image":"https://avatars.githubusercontent.com/u/169750518?v=4"},"moderation":null}