Forge — 统一 AI 编码工作流框架
统一 /forge 入口 + 21 个内部子命令覆盖完整开发生命周期，三维路由自动匹配复杂度，统一状态系统跨会话感知。
前置条件：Claude Code ≥ 2.1.153 | 安装指南
完整兼容性矩阵和降级策略见 docs/claude-code-compatibility.md
核心价值
- 21 个命令覆盖从需求分析到代码交付的完整周期
- 三维路由自动匹配任务复杂度（轻量/标准/全量）
- 统一状态目录
.forge/，跨命令状态感知和会话恢复
- 按需加载，单次会话约 10K tokens
- TDD 强制 + 三层独立评审，保障代码质量
快速开始
# 1. 安装（Plugin 方式，推荐）
claude plugin marketplace add https://github.com/kkkman22/Forge
claude plugin install forge
# 2. 初始化项目（仅首次）
/forge init
# 3. 验证安装
/forge status
# 4. 第一次使用
/forge 修复 README 中的拼写错误
完整快速入门指南（含 3 种安装方式、故障排除、端到端示例）→ docs/quick-start.md
文档导航
Gate Skills 对比
| 维度 | /forge accept | /forge verify | /forge ship |
|---|
| 触发时机 | Spec 验收场景执行 | 证据化三态验证收尾 | 最终交付前合规/合并/release |
| 主要责任 | 运行场景脚本并记录验收结果 | 汇总所有证据、产出三态结论 | 综合前置门禁、执行合并/tag |
| 典型输出 | .forge/acceptance/<scenario>.md | .forge/findings/<topic>/verify-this/ | PR merge + tag + CHANGELOG |
| 下游接续 | → /forge verify 或 /forge ship --with-acceptance | → /forge ship | Release 完成 |
安装方式
Plugin 安装（推荐）
claude plugin marketplace add https://github.com/kkkman22/Forge
claude plugin install forge
所有新用户推荐此方式。无需 git 或 Node.js。
直接克隆（Forge Loop 开发者）
git clone https://github.com/kkkman22/Forge.git ~/.claude/skills/forge
包含完整功能：/forge 命令 + Forge Loop 带工程纪律的自主执行引擎。额外需要 npm install && npx tsc。
分发包安装（企业内网）
git clone https://github.com/kkkman22/Forge.git /tmp/forge
bash /tmp/forge/scripts/build-dist.sh
bash /tmp/forge/scripts/install-dist.sh
只含 /forge 命令，不含 Forge Loop。适合团队统一部署。
bin/ 命令
Plugin 安装后，以下命令可直接在终端使用：
| 命令 | 说明 |
|---|
forge-doctor | 项目健康检查（.forge/ 结构、配置、hooks） |
forge-status | 显示当前任务状态（tier/phase/progress） |
forge-restate | 触发 restatement checkpoint（可选 --check 工具） |
所有命令支持 --help。
自带 forge-context MCP
Forge plugin 自带 forge-context first-party MCP server，为 /forge review 提供智能 diff 截断和上下文优化。
- 零网络：通过 stdio 在本地运行，不发起任何外部请求
- 零配置：marketplace 安装后自动启用，源仓库用户由 init.sh 配置
- 智能优先级：源码 > 配置 > 测试 > 生成文件 > lock，确保关键变更进入 token 预算
实测效果：/forge review 19 文件变更场景 token 消耗从 700K+ 降至 <200K。
命令概览
| 命令 | 说明 | 路径 |
|---|
/forge | 入口，三维路由分析任务 | 所有 |
/forge plan | 将 Spec 拆解为原子任务 | 标准、全量 |
/forge build | 按计划 TDD 实现代码 | 所有 |
/forge review | 三层独立评审 | 所有 |
/forge test | 运行完整验证套件 | 标准、全量 |
/forge ship | 门禁检查 + 交付 | 标准、全量 |
/forge decide | 四视角前置决策 | 全量 |
/forge learn | 五维度经验沉淀 | 全量 |
/forge spec | 将需求固化为可锁定规格 | 全量 |
/forge verify | 证据化三态验证 | 所有 |
/forge accept | 场景验收执行 | 所有 |
/forge debug | 四阶段结构化根因分析 | 所有 |
/forge status | 查看当前任务状态 | 所有 |
/forge resume | 会话恢复 | 所有 |
/forge grill | 苏格拉底式需求澄清 | 所有 |
/forge storm | 头脑风暴 | 所有 |
/forge recap | 会话摘要与上下文回顾 | 所有 |
/forge loop | 带工程纪律的自主循环 | 所有 |
完整子命令速查表和三维路由详解 → docs/reference-commands.md
三维路由
| 档位 | 判定条件 | 命令序列 |
|---|
| 轻量路径 | 影响 ≤1 文件，改动 ≤20 行 | build → review |
| 标准路径 | 需求明确或有现成 Spec | plan → build → review → test → ship |
| 全量路径 | 新服务/数据库/认证变更或需求模糊 | decide → spec → plan → build → review → test → ship → learn |
安全
