Forge

规范驱动的 AI 辅助开发工作流（Claude Code / Codex Skills）

先充分讨论，再写文档明确需求，再基于文档设计和实现。 无 Feature Spec 不写代码。无验收计划不跑测试。发现问题必须举一反三。

这是什么 · 快速开始 · Skill 清单 · 关键机制 · 安装 · 设计哲学 · 文档导航

---

这是什么

Forge 是一套覆盖从头脑风暴到发布复盘完整开发链路的 Claude Code / Codex Skills：14 个专职 Skill + 1 个总入口 /forge。既可全链路串联（/forge-dev --full 从需求一路编排到发布），也可单独调用任意一环（比如只用 /forge-eng 写代码）。

核心理念是规范驱动开发（Spec-Driven Development）：每个功能在写代码前必须有 Feature Spec——Given/When/Then 行为场景 + 验收检查表——经用户确认后才进入开发；QA 基于同一份 Spec 逐项断言。文档是 Skill 之间传递上下文的唯一通道，不依赖会话历史。

解决的核心问题

问题	没有 Forge	有 Forge
讨论不足，直接开干	口头一说就写代码	forge-brainstorm 多轮讨论 → 方案确认
需求模糊，验收靠人肉	PRD 没有精确验收标准	Feature Spec（Given/When/Then + 验收检查表）→ 用户确认后才开发
QA 测不出问题	只测"元素存在"不测"符合设计"	基于验收检查表逐项断言（含 CSS 属性值）
反馈后不举一反三	报了 3 个 bug，只修 3 个	搜索相似模式 → 类似风险清单 → 一并修复
设计粗糙，改了又改	简单想法直接写	forge-design 自闭环（竞品 + 美学 + 99 条 UX 规则 + 门控）
AI 长会话质量劣化	一个会话干到底	上下文工程：调度器精简，子任务独立上下文
教训不沉淀，问题复发	复盘写完就忘	forge-fupan 账本 + 开工自动回放 + 复发检测
不知道下一步	记住所有 skill 名字	/forge 检查状态，推荐下一步

---

系统全景

用户有想法
       │
       ▼
  ┌─────────────────┐
  │ forge-brainstorm │  头脑风暴 → 思考文档
  └──────┬──────────┘  4 模式：产品 · 内容 · 构建 · 探索
         │
         ▼
  ┌──────────┐
  │ forge-prd│  产品诊断 → PRD 当前事实 + .features Feature Spec + CHANGELOG
  └────┬─────┘  ⚠️ Feature Spec 用户确认后才进入开发
       │
       ▼
  ┌──────────┐
  │ forge-dev│  调度器 → Discussion → Research → 子技能调度
  └────┬─────┘  --full 尾段可一路编排到发布
       │ 独立上下文执行
  ┌────┼──────────────────────┐
  ▼    ▼                      ▼
┌──────────┐ ┌──────────────┐ ┌──────────┐ ┌──────────┐
│  forge-  │ │forge-design- │ │  forge-  │ │  forge-  │
│  design  │ │    impl      │ │   eng    │ │    qa    │
└──────────┘ └──────────────┘ └──────────┘ └──────────┘
 设计规划      设计→代码        工程实现      QA 验收
 自闭环                       TDD+Worktree  验收计划→测试
                                            →举一反三
       │
       ▼
  ┌──────────┐   ┌──────────┐   ┌──────────┐
  │  forge-  │ → │  forge-  │ → │  forge-  │
  │  review  │   │   ship   │   │  fupan   │
  └──────────┘   └──────────┘   └──────────┘
   代码审查       发布流程       复盘沉淀

随时：/forge → 检查项目状态，推荐下一步

---

快速开始

场景 A：新想法

/forge-brainstorm  → 讨论想法，产出思考文档
/forge-prd         → PRD 当前事实 + .features Feature Spec（用户确认后才开发）
/forge-dev         → 调度设计 + 工程 + QA

场景 B：已有 PRD

/forge-dev         → 检查 Feature Spec → 调度

场景 C：不知道下一步

/forge             → 检查状态，告诉你该做什么

场景 D：单独调用

/forge-eng         → 只写代码（Worktree + TDD）
/forge-qa          → 只跑验收测试
/forge-bugfix      → 系统性修 Bug

场景 E：全自动交付

/forge-dev --full   → 从需求一路编排到发布（review → ship → doc-release）
/forge-dev --resume → 从检查点恢复

forge-deliver 已于 2026-07-04 退役并入 forge-dev（归档在 _archive/2026-07-04-forge-deliver-retired/）。

场景 F：新项目一键接入

~/.claude/skills/forge-doc-policy/scripts/init-project.sh
                    → 幂等铺好 docs/、.features/、.forge/ 状态文件

---

效果示例

Feature Spec 确认门禁

用户    ❯ 帮我加一个频道管理功能

forge   ❯ ⚠️ 该功能没有 Feature Spec。建议先运行 /forge-prd 生成。

用户    ❯ /forge-prd

forge   ❯ Feature Spec 已生成，请审阅：
          一、用户流程：设置页 → 频道列表 → 添加/删除/排序 → 保存
          二、页面结构：3 个区块，5 个组件
          三、行为场景：3 个功能点，共 9 个 Given/When/Then 场景
          四、验收检查表：18 项（功能 9 + 视觉 6 + 流程 3）
          
          A) 确认，进入开发
          B) 整体方向需要调整
          C) 细节需要修改

举一反三

用户    ❯ 频道卡片的间距不对，应该是 16px 不是 12px