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 Skill 升级优化
/deploy Drone CI/CD 全流程部署引导
/changelog 一键发版(日志 + commit + tag

安装 & 更新

一行命令搞定安装和更新。脚本会智能处理:新 skill 直接装,已有的对比更新,本地魔改自动备份。

# 在你的项目根目录执行(首次安装 & 后续更新都用这条)
bash <(curl -sL https://git.internal.intelligrow.cn/zhangfucai/spec-coding-skills/raw/branch/main/install.sh)

或者先下载再执行:

curl -sL https://git.internal.intelligrow.cn/zhangfucai/spec-coding-skills/raw/branch/main/install.sh -o /tmp/install-skills.sh
bash /tmp/install-skills.sh

更新策略

情况 处理方式
新 skill本地没有 直接安装
本地未改 + 上游有更新 直接覆盖
本地魔改过 + 上游有更新 写入上游新版,本地版备份为 SKILL.md.local.bak
本地和上游一致 跳过

恢复本地版本:mv SKILL.md.local.bak SKILL.md 对比差异:diff SKILL.md SKILL.md.local.bak

使用示例

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

Description
No description provided
Readme 322 KiB
Languages
Python 90.4%
Shell 9.6%