Spec Coding Skills
一套同时支持 Claude Code 和 Codex 的 Skills，覆盖产品文档工作流的完整生命周期管理。
平台适配
| 平台 | 安装目录 | 触发方式 |
|---|---|---|
| Claude Code | .claude/skills/ |
/rr、/wp、/go 这类 slash commands |
| Codex | .codex/skills/ |
$rr、$wp，或直接自然语言说明“用 rr skill 评审需求文档” |
Codex 额外需要项目根目录存在
AGENTS.md。本仓库已提供AGENTS.md.template，安装脚本在 Codex 模式下会自动生成。
功能概览
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 列表
| 类型 | Skill | Claude Code | Codex | 描述 |
|---|---|---|---|---|
| Review | rr |
/rr |
$rr |
评审 RequirementsDoc.md |
rp |
/rp |
$rp |
评审 PRD.md | |
rf |
/rf |
$rf |
评审 FeatureSummary.md | |
rd |
/rd |
$rd |
评审 DevelopmentPlan.md | |
ru |
/ru |
$ru |
评审 UIDesign.md | |
rt |
/rt |
$rt |
评审 tasks.md | |
| Write | wp |
/wp |
$wp |
从 RequirementsDoc 生成 PRD |
wf |
/wf |
$wf |
从 PRD 生成 FeatureSummary | |
wd |
/wd |
$wd |
从 FeatureSummary 生成 DevelopmentPlan | |
wu |
/wu |
$wu |
从 DevelopmentPlan 生成 UIDesign | |
wt |
/wt |
$wt |
从 DevelopmentPlan 生成 tasks | |
| Modify | mr |
/mr |
$mr |
增量修改 RequirementsDoc |
mp |
/mp |
$mp |
增量修改 PRD（自动读取评审报告） | |
mf |
/mf |
$mf |
增量修改 FeatureSummary | |
md |
/md |
$md |
增量修改 DevelopmentPlan | |
mu |
/mu |
$mu |
增量修改 UIDesign | |
mt |
/mt |
$mt |
增量修改 tasks | |
| 执行 | go |
/go |
$go |
🚀 发射按钮，激进模式一口气完成开发 |
| 辅助 | iter |
/iter |
$iter |
迭代变更入口（Bug/功能/重构） |
doc |
/doc |
$doc |
渐进式文档生成器，先写梗概再迭代完善 | |
update |
/up |
$update 或 $up |
Skill 升级优化 | |
deploy |
/deploy |
$deploy |
Drone CI/CD 全流程部署引导 | |
changelog |
/changelog |
$changelog |
一键发版（日志 + commit + tag） |
安装 & 更新
一行命令搞定安装和更新。脚本会智能处理：新 skill 直接装，已有的对比更新，本地魔改自动备份。
# Claude Code + Codex（推荐）
bash <(curl -sL https://git.internal.intelligrow.cn/zhangfucai/spec-coding-skills/raw/branch/main/install.sh) both
# Codex only
bash <(curl -sL https://git.internal.intelligrow.cn/zhangfucai/spec-coding-skills/raw/branch/main/install.sh) codex
# Claude Code only
bash <(curl -sL https://git.internal.intelligrow.cn/zhangfucai/spec-coding-skills/raw/branch/main/install.sh) claude
或者先下载再执行：
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 both
安装脚本行为
both模式：同时安装.codex/skills/和.claude/skills/，并生成AGENTS.md+CLAUDE.mdcodex模式：安装到.codex/skills/，并在项目根目录生成或更新AGENTS.mdclaude模式：安装到.claude/skills/，并在项目根目录生成或更新CLAUDE.md- 如果传入自定义目标目录，脚本会优先安装 Codex 版 skills；目标路径包含
.claude/skills时自动切到 Claude 版
推荐用法
- 团队项目、模板仓库：用
both，一次安装双端，最省心 - 只有你自己在 Codex 里用：用
codex - 仓库明确只服务 Claude Code：用
claude
更新策略
| 情况 | 处理方式 |
|---|---|
| 新 skill（本地没有） | 直接安装 |
| 本地未改 + 上游有更新 | 直接覆盖 |
| 本地魔改过 + 上游有更新 | 写入上游新版，本地版备份为 SKILL.md.local.bak |
| 本地和上游一致 | 跳过 |
恢复本地版本：mv SKILL.md.local.bak SKILL.md
对比差异：diff SKILL.md SKILL.md.local.bak
使用示例
0->1 阶段：从需求到开发
Claude Code:
/wp
/wf
/wd
/wt
/go
Codex:
$wp
$wf
$wd
$wt
$go
1->100 阶段：持续迭代
Claude Code:
/iter
/go
Codex:
$iter
$go
也可以直接说自然语言，例如：
请用 rr skill 评审 doc/RequirementsDoc.md
请用 wf skill 根据 PRD 生成 FeatureSummary
请用 go skill 按 doc/tasks.md 执行未完成任务
请用 doc skill 为认证模块写一份 300 字以内的使用说明
工作流总览
┌─────────────────────────────────────────────────────────┐
│ 0->1 全新项目 │
│ │
│ 需求 → wp → wf → wd → wt → go 🚀 │
│ │
├─────────────────────────────────────────────────────────┤
│ 1->100 持续迭代 │
│ │
│ 发现问题 → iter → go 🚀 │
│ │
└─────────────────────────────────────────────────────────┘
文档定位
| 文档 | 定位 | 受众 |
|---|---|---|
| PRD | 「价值主张」- 业务语言描述产品价值 | 产品、业务、管理层 |
| FeatureSummary | 「功能契约」- 精确定义功能边界 | 产品与开发的桥梁 |
| DevelopmentPlan | 「执行蓝图」- 技术方案和排期 | 开发团队 |
| UIDesign | 「界面蓝图」- ASCII 原型图 | 前端开发 |
| tasks | 「任务清单」- 可执行的开发任务 | 开发执行 |
目录结构
your-project/
├── AGENTS.md # ← Codex 项目入口（Codex 模式）
├── CLAUDE.md # ← Claude Code 项目入口（Claude 模式）
├── .codex/
│ └── skills/ # ← Codex Skills 安装位置
│ ├── rr/
│ ├── rp/
│ ├── ...
│ └── iter/
├── .claude/
│ └── skills/ # ← Claude Code 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