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 Submodule（推荐）

```bash
# 在你的项目根目录执行
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
```

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

### 方式 2：直接复制

```bash
# 克隆仓库
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
```

## 更新 Skills

### Submodule 方式

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

### 直接复制方式

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

## 使用示例

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

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

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

### 1->100 阶段：持续迭代

```bash
# 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 使用注释标记追踪文档变更：

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

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

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

## License

MIT