# Spec Coding Skills 一套同时支持 Claude Code 和 Codex 的 Skills，覆盖产品文档工作流的完整生命周期管理。 ## 平台适配 | 平台 | 安装目录 | 触发方式 | |------|----------|----------| | Claude Code | `.claude/skills/` | `/rr`、`/wp`、`/go` 这类 slash commands | | Codex | `.codex/skills/` | `/rr`、`/wp` 这类 slash commands，或直接自然语言说明“用 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` | `/up` | Skill 升级优化 | | | `deploy` | `/deploy` | `/deploy` | Drone CI/CD 全流程部署引导 | | | `issue` | `/issue` | `/issue` | 通用 Gitea issue 查询（支持当前仓库自动识别） | | | `issue-drive` | `/issue-drive` | `/issue-drive` | 通用 Gitea issue 拆单与批量创建 | | | `changelog` | `/changelog` | `/changelog` | 一键发版（日志 + commit + tag） | > Codex 兼容历史 `$skill` 写法，但本文档统一以 `/skill` 作为主入口。 ## 安装 & 更新 一行命令搞定安装和更新。脚本会智能处理：新 skill 直接装，已有的对比更新，本地魔改自动备份。 ```bash # 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 ``` 或者先下载再执行： ```bash 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.md` - `codex` 模式：安装到 `.codex/skills/`，并在项目根目录生成或更新 `AGENTS.md` - `claude` 模式：安装到 `.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: ```bash /wp /wf /wd /wt /go ``` Codex: ```text /wp /wf /wd /wt /go ``` ### 1->100 阶段：持续迭代 Claude Code: ```bash /iter /go ``` Codex: ```text /iter /go ``` 也可以直接说自然语言，例如： ```text 请用 rr skill 评审 doc/RequirementsDoc.md 请用 wf skill 根据 PRD 生成 FeatureSummary 请用 go skill 按 doc/tasks.md 执行未完成任务 请用 doc skill 为认证模块写一份 300 字以内的使用说明 请用 issue skill 查看当前仓库的 open issues 请用 issue-drive skill 把当前 bug 拆成两张 Gitea issue ``` ### 查询 Gitea Issues 先配置环境变量： ```bash export GITEA_TOKEN=your_gitea_token export GITEA_ISSUE=your_gitea_write_token # 可选，写 issue 时优先使用 export GITEA_BASE_URL=https://git.example.com # 可选；owner/repo 简写或 SSH origin 时推荐配置 ``` Claude Code: ```bash /issue /issue 7 /issue owner/repo /issue https://git.example.com/owner/repo /issue https://git.example.com/owner/repo --state=all --limit=20 /issue https://git.example.com/owner/repo 7 ``` Codex: ```text /issue /issue 7 /issue owner/repo /issue https://git.example.com/owner/repo /issue https://git.example.com/owner/repo --state=all --limit=20 /issue https://git.example.com/owner/repo 7 ``` 说明： - 直接 `/issue` 或 `/issue 7` 时，skill 会优先从当前项目的 `git origin` 自动识别仓库 - 传 `owner/repo` 时，需要 `GITEA_BASE_URL` - 当前仓库 `origin` 是 SSH 地址时，建议配置 `GITEA_BASE_URL`，避免 Web/API 域名与 SSH 域名不一致 ### 创建 Gitea Issues Claude Code: ```bash /issue-drive ``` Codex: ```text /issue-drive ``` 自然语言也可以： ```text 请用 issue-drive skill 把当前仓库这个线上 bug 拆成两张 Gitea issue 请用 issue-drive skill 给 owner/repo 创建一张工程任务 issue，内容是补齐告警和回归测试 ``` `issue-drive` 会优先从当前仓库 `origin` 推断目标仓库；如果你显式指定其他仓库，skill 会按用户输入创建 issue。 ### 工作流总览 ``` ┌─────────────────────────────────────────────────────────┐ │ 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/ │ └── issue-drive/ ├── .claude/ │ └── skills/ # ← Claude Code Skills 安装位置 │ ├── rr/ │ ├── rp/ │ ├── ... │ ├── iter/ │ └── issue-drive/ ├── doc/ # ← 文档输出位置 │ ├── RequirementsDoc.md │ ├── PRD.md │ ├── FeatureSummary.md │ ├── DevelopmentPlan.md │ ├── UIDesign.md │ └── tasks.md └── ... ``` ## 标记规范 Skills 使用注释标记追踪文档变更： ```markdown 新增内容... 修改后的内容 迭代变更内容 ``` ## License MIT