SkillHub

spec-coding

v1.0.0

规格驱动编程工作流。根据用户需求生成 Spec 文档（功能/API/组件），或为现有代码逆向生成规格文档。使用场景：(1) 新项目启动时先写规格，(2) 老项目补规格文档，(3) 需求评审时生成规格草稿，(4) 代码审查时对照规格验收。

Sourced from ClawHub, Authored by pupuking723

Installation

Please help me install the skill `spec-coding` from SkillHub official store. npx skills add pupuking723/spec-coding

Spec Coding 规格驱动编程

核心工作流

场景 1：新项目生成规格文档

当用户提出新需求时：

  1. 判断规格类型
  2. 功能需求 → 使用 feature-spec.md 模板
  3. API 接口 → 使用 api-spec.md 模板

  4. UI 组件 → 使用 component-spec.md 模板

  5. 生成规格草稿

  6. 读取对应模板（见 assets/templates/）
  7. 根据用户需求填充各章节

  8. 重点明确：输入/输出规格、边界情况、验收标准

  9. 输出格式 ```markdown # [功能名称] 规格文档

状态: draft 创建日期: YYYY-MM-DD

[完整规格内容] ```

  1. 后续流程
  2. 用户评审 → 修改 → 批准
  3. 状态改为 approved 后交付开发
  4. 开发完成后对照规格验收

场景 2：老项目逆向生成规格

当用户需要为现有代码补规格文档时：

  1. 读取源代码
  2. 功能代码 → 分析输入/输出/行为
  3. API 代码 → 提取路由/参数/响应格式

  4. 组件代码 → 分析 Props/状态/交互

  5. 生成规格文档

  6. 对照模板填充已知信息
  7. 标注「待确认」章节（需要用户补充）

  8. 输出 review 状态文档

  9. 输出示例 ```markdown ## 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 → done
  • draft: 草稿，待用户补充信息
  • review: 待评审，等待用户确认
  • approved: 已批准，可交付开发
  • in-progress: 开发中
  • done: 已完成验收

输出原则

  1. 结构化优先 - 使用表格、代码块、列表
  2. 明确边界 - 必须列出所有边界情况和错误处理
  3. 可验收 - 每条规格都可被验证（是/否）
  4. 简洁 - 避免冗长描述，用示例代替解释

与子代理协作

  • 研究员: 搜集竞品规格、行业标准
  • 文案师: 润色用户提示文案、错误消息
  • 落地执行: 根据规格实现代码、编写测试

参考文档

  • 详细模板说明：assets/templates/README.md
  • 规格示例：assets/examples/