spec-coding-skills/README.md

Spec Coding Skills

一套 Claude Code Skills，支持产品文档工作流的完整生命周期管理。

功能概览

RequirementsDoc ──▶ PRD ──▶ FeatureSummary ──▶ DevelopmentPlan ──▶ UIDesign ──▶ tasks
      │              │            │                  │               │           │
     /rr            /rp          /rf                /rd             /ru         /rt   ← Review
     /mr            /mp          /mf                /md             /mu         /mt   ← Modify
                    /wp          /wf                /wd             /wu         /wt   ← Write

Skills 列表

类型	命令	描述
Review	/rr	评审 RequirementsDoc.md
	/rp	评审 PRD.md
	/rf	评审 FeatureSummary.md
	/rd	评审 DevelopmentPlan.md
	/ru	评审 UIDesign.md
	/rt	评审 tasks.md
Write	/wp	从 RequirementsDoc 生成 PRD
	/wf	从 PRD 生成 FeatureSummary
	/wd	从 FeatureSummary 生成 DevelopmentPlan
	/wu	从 DevelopmentPlan 生成 UIDesign
	/wt	从 DevelopmentPlan 生成 tasks
Modify	/mr	增量修改 RequirementsDoc
	/mp	增量修改 PRD（自动读取评审报告）
	/mf	增量修改 FeatureSummary
	/md	增量修改 DevelopmentPlan
	/mu	增量修改 UIDesign
	/mt	增量修改 tasks
执行	/go	🚀 发射按钮，激进模式一口气完成开发
辅助	/iter	迭代变更入口（Bug/功能/重构）
	/up	文档升级迁移

安装方式

方式 1：直接复制

# 克隆仓库
git clone https://git.internal.intelligrow.cn/zhangfucai/spec-coding-skills.git /tmp/spec-coding-skills

# 复制 skills 到你的项目
mkdir -p .claude
cp -r /tmp/spec-coding-skills/.claude/skills .claude/

# 清理
rm -rf /tmp/spec-coding-skills

方式 2：Git Submodule

# 在你的项目根目录执行
git submodule add https://git.internal.intelligrow.cn/zhangfucai/spec-coding-skills.git .spec-coding-skills

# 创建符号链接
mkdir -p .claude
ln -s ../.spec-coding-skills/.claude/skills .claude/skills

# 提交变更
git add .gitmodules .spec-coding-skills .claude/skills
git commit -m "Add spec-coding-skills as submodule"

更新 Skills

Submodule 方式

# 更新到最新版本
git submodule update --remote .spec-coding-skills

直接复制方式

重新执行复制命令覆盖即可。

使用示例

0->1 阶段：从需求到开发

# 1. 准备文档
/wp   # 生成 PRD
/wf   # 生成 FeatureSummary
/wd   # 生成 DevelopmentPlan
/wt   # 生成 tasks

# 2. 发射！
/go   # 激进模式，一口气完成所有任务

1->100 阶段：持续迭代

# 1. 描述变更需求
/iter  # 调研 → 澄清 → 更新 PRD 和 tasks

# 2. 执行变更
/go    # 自动识别新任务并执行

工作流总览

┌─────────────────────────────────────────────────────────┐
│                     0->1 全新项目                        │
│                                                         │
│  需求 → /wp → /wf → /wd → /wt → /go 🚀                 │
│                                                         │
├─────────────────────────────────────────────────────────┤
│                    1->100 持续迭代                       │
│                                                         │
│  发现问题 → /iter → /go 🚀                              │
│                                                         │
└─────────────────────────────────────────────────────────┘

文档定位

文档	定位	受众
PRD	「价值主张」- 业务语言描述产品价值	产品、业务、管理层
FeatureSummary	「功能契约」- 精确定义功能边界	产品与开发的桥梁
DevelopmentPlan	「执行蓝图」- 技术方案和排期	开发团队
UIDesign	「界面蓝图」- ASCII 原型图	前端开发
tasks	「任务清单」- 可执行的开发任务	开发执行

目录结构

your-project/
├── .claude/
│   └── skills/          # ← Skills 安装位置
│       ├── rr/
│       ├── rp/
│       ├── ...
│       └── iter/
├── doc/                  # ← 文档输出位置
│   ├── RequirementsDoc.md
│   ├── PRD.md
│   ├── FeatureSummary.md
│   ├── DevelopmentPlan.md
│   ├── UIDesign.md
│   └── tasks.md
└── ...

标记规范

Skills 使用注释标记追踪文档变更：

<!-- NEW START -->
新增内容...
<!-- NEW END -->

<!-- MODIFIED: 原内容为 "xxx" -->
修改后的内容

<!-- ITER: 2024-01-23 - 修复登录验证漏洞 -->
迭代变更内容

License

MIT