Goal Workflow 使用指南
AI-driven development workflow — from PRD to shipped code
github.com/smallnest/goal-workflow
Usage Guide — 四步闭环研发工作流：规划、实现、审查、交付。
目录
1. 概述
Goal Workflow 是一套基于 Claude Code / Codex 的 AI 研发工作流技能集，将软件开发的完整生命周期拆分为四个标准化步骤，每一步都由一个专属 Skill 驱动。
它让 AI Agent 能够像一个有经验的工程师一样——从理解需求、拆解任务、编写代码、审查质量，到最终提交合入——全流程自主完成。你只需描述功能想法，剩下的交给工作流。
/prd
需求文档生成 + Issue 拆解
- 澄清问题 → 结构化 PRD
- 拆解为独立可实施的 Issue
- 支持 GitHub / Local / iCafe
/goal
选择卡片进行端到端实现
- Pick an Issue, implement it
- 单次会话完成一个功能
- Claude Code 或 Codex
/review-it
自动化代码审查与修复
- 检测未提交变更或分支 diff
- 验证发现 → 迭代修复
- 直到审查通过为止
/ship-it
提交 → PR → 合入 → 关闭
- Commit 关联 Issue 编号
- Squash merge + delete branch
- 添加实现总结并关闭卡片
2. 安装
通过 npx skills CLI 一键安装所有技能：
# 安装本仓库所有 skills
npx skills add smallnest/goal-workflow
# 或安装指定 skill
npx skills add smallnest/goal-workflow --skill prd
npx skills add smallnest/goal-workflow --skill review-it
npx skills add smallnest/goal-workflow --skill ship-it
# 全局安装（所有项目可用）
npx skills add smallnest/goal-workflow -g
# 安装到指定 agent
npx skills add smallnest/goal-workflow -a claude-code前置要求
| 工具 | 用途 | 安装 |
|---|---|---|
gh | GitHub CLI (Issue/PR 操作) | brew install gh && gh auth login |
claude | Claude Code CLI | npm install -g @anthropic-ai/claude-code |
npx | npm package runner | Node.js 自带 |
/prd、/review-it、/ship-it 即可直接调用对应技能。
3. 工作流总览
四步闭环，从需求到交付：
| 步骤 | 命令 | 输入 | 输出 |
|---|---|---|---|
| 1. 规划 | /prd |
功能描述 / 产品想法 | PRD 文档 + Issue 卡片 |
| 2. 实现 | /goal |
一个 Issue 卡片 | 可运行的代码实现 |
| 3. 审查 | /review-it |
代码变更 (dirty / branch) | 通过审查的干净代码 |
| 4. 交付 | /ship-it |
已审查的代码 | 已合入的 PR + 已关闭的 Issue |
4. Step 1: /prd — 需求规划
/prd 将一个模糊的功能想法转化为结构化的产品需求文档，并拆解为可独立实施的 Issue 卡片。
触发方式
# 在 Claude Code 中直接输入
/prd 给我们的任务管理系统加一个优先级功能
# 或使用触发词
写PRD：用户注册功能，支持邮箱和手机号
需求分析：为 API 增加限流能力工作流程
- Agent 提出 3-5 个澄清问题（带字母选项，可快速回复 "1A, 2C, 3B"）
- 根据回答生成结构化 PRD（用户故事、功能需求、非目标、验收标准）
- 展示 PRD 供审阅，确认或调整
- 保存 PRD 到
tasks/prd-[feature-name].md - 拆解 PRD 为 Issue 列表，展示供确认
- 选择创建模式（GitHub / Local / Baidu iCafe）并创建 Issue
输出示例
# 生成的 Issue 列表
📋 Generated 4 Issues from PRD:
#1: Add priority field to database (backend, high)
#2: Display priority indicator (frontend, high) — depends on #1
#3: Add priority selector (frontend, medium) — depends on #1
#4: Filter tasks by priority (frontend, medium) — depends on #1, #25. Step 2: /goal — 功能实现
/goal 是 Claude Code 内置的目标驱动开发模式。选择一个 Issue 卡片，Agent 会理解验收标准并端到端实现。
使用方式
# Claude Code: 指定 GitHub Issue 编号
/goal #42
# Claude Code: 指定本地 Issue 文件
/goal tasks/issues/issue-001-add-priority-field.md
# Codex: 使用 --goal 参数
codex --goal "Implement issue #42: Add priority field to database"Agent 行为
- 读取 Issue 描述和验收标准
- 分析代码库结构，理解上下文
- 编写实现代码
- 运行测试和类型检查
- 对 UI 变更在浏览器中验证
- 逐条确认验收标准满足
/goal 是 Claude Code 的内置功能，不包含在本 skill 包中。它与本工作流天然配合——/prd 生成的 Issue 格式正是 /goal 所期望的输入。
6. Step 3: /review-it — 代码审查
/review-it 在代码提交前进行自动化审查，发现潜在问题并迭代修复，直到审查通过。
触发方式
# 审查未提交的变更（默认模式）
/review-it
# 审查整个分支 vs main
/review-it --mode branch
# 审查 + 测试并行执行
/review-it --parallel-tests "npm test"审查原则
| 原则 | 说明 |
|---|---|
| Advisory | 审查结果视为建议，不盲目应用 |
| Verify | 每个发现都通过读取真实代码路径验证 |
| Reject noise | 拒绝不切实际的边界情况、投机性风险、过度重构 |
| Iterate | 修复后重新审查，直到无可操作发现 |
| Minimal | 优先小修复，不做不必要的大重构 |
审查模式
| 工作树状态 | 模式 | 操作 |
|---|---|---|
| 有未提交变更 | local | 直接 /review |
| 已提交未推送 | branch | git diff origin/main...HEAD + review |
| 已推送 / PR | branch | 同上，自动检测 PR base |
| 干净工作树 | skip | 无需审查 |
/review-it 支持 Claude Code、Codex、OpenCode 和 DeepSeek TUI，会自动适配各 Agent 的审查命令。
7. Step 4: /ship-it — 提交交付
/ship-it 是实现完成后的标准收尾流程：提交代码、创建 PR、合入、添加实现总结、关闭 Issue。
触发方式
# 在 Claude Code 中调用
/ship-it
# 或使用触发词
提交代码
创建PR并合入完整流程
# Step 1: 提交代码（关联 Issue）
git add <related files>
git commit -m "Add priority field to database (#42)"
# Step 2: 推送分支
git push -u origin feat/issue-42-priority-field
# Step 3: 创建 PR（body 包含 Closes #42）
gh pr create --title "Add priority field" \
--body "Closes #42 ..."
# Step 4: 合入
gh pr merge --squash --delete-branch
# Step 5: 关闭 Issue（如未自动关闭）
gh issue close 42 --reason completed错误处理
| 场景 | 处理方式 |
|---|---|
| CI checks 失败 | 查看失败原因，修复后追加 commit 推送 |
| Merge conflict | Rebase origin/main，解决冲突后 force push |
| Branch protection | 确认 required reviews 已满足 |
| Issue 未自动关闭 | 确认 PR body 包含 Closes #N，或手动关闭 |
/ship-it 依赖 gh CLI。确保已通过 gh auth login 完成认证。
8. 支持的平台
Goal Workflow 的技能可在多个 AI Coding Agent 中使用：
| Agent | /prd | /goal | /review-it | /ship-it |
|---|---|---|---|---|
| Claude Code | ✓ | ✓ (内置) | ✓ | ✓ |
| Codex | ✓ | ✓ (--goal) | ✓ | ✓ |
| OpenCode | ✓ | — | ✓ | ✓ |
| DeepSeek TUI | ✓ | — | ✓ | ✓ |
Issue 创建平台
| 平台 | 工具 | 说明 |
|---|---|---|
| GitHub | gh issue create | 需要 gh CLI 认证 |
| Local | Markdown 文件 | 保存到本地目录 |
| Baidu iCafe | icafe-cli | 需要 iCafe 空间参数 |
9. FAQ
Q: 必须按顺序使用四个步骤吗？
不必。每个 Skill 都是独立的，可以单独使用。比如你已经有 Issue 了，可以直接从 /goal 开始；代码已经写好，可以直接用 /review-it 审查。但完整走一遍四步流程能获得最好的效果。
Q: /goal 是哪里来的？为什么没有在 skills 目录中？
/goal 是 Claude Code 的内置功能，不需要额外安装。本工作流的 /prd 生成的 Issue 格式与 /goal 的期望输入完全匹配。
Q: 可以在非 GitHub 项目中使用吗？
可以。/prd 支持将 Issue 保存为本地 Markdown 文件或创建到百度 iCafe。/review-it 只需要本地 git 仓库。/ship-it 目前依赖 GitHub（gh CLI）。
Q: /review-it 和手动 code review 的区别？
/review-it 是自动化的自查（self-review），在提交前发现明显问题。它不替代团队 code review，而是在 PR 创建前提升代码质量，减少 reviewer 需要指出的低级问题。
Q: Issue 粒度应该多大？
每个 Issue 应该是一个 Agent 在单次会话中可以完成的工作量——通常是 1-3 个文件的变更，有明确的验收标准。/prd 会自动按这个粒度拆解，但你可以在确认前调整。
Q: 如何在 Codex 中使用？
通过 npx skills add 安装时选择 -a codex。在 Codex 中使用 codex --goal "..." 替代 /goal，/review-it 在各 Agent 中通用。