用途:Forge 是受跟踪实现工作的 SDLC 生命周期层,负责特性/PRD/切片状态、活动切片归属、Git 边界、TDD/验证/评审证据、交接、修订与关闭就绪。CLI 与 Forge 内核掌握阶段顺序、不变量与关闭门禁。
主要能力:生命周期链为 research → plan → implement(TDD 循环)→ verify → review → close。TDD 强制;定向验证、评审与关闭不可跳过,仅测试通过不能关闭工作。阶段包(phasePacket)是工作流真相,若文字与包冲突以包为准。
使用方式:面向智能体只有 7 个命令:wiki resume <project> --repo <path> --base <rev>;wiki forge next <project> --json;wiki forge plan <project> <feature> --scaffold --json;wiki forge plan <project> <feature> --plan-answer-file <path>;wiki forge plan <project> <feature> --create-artifacts;wiki forge run <project> [slice-id] --repo <path>;wiki handover <project> --repo <path> --json;wiki ask <project> <question...>;wiki search [--hybrid] <query...>。forge next 返回阶段包,指明下一步内部命令、需加载技能与可写文件,应遵循包而非手动选择内部命令。
适用场景:受跟踪的实现工作、特性规划、切片执行、证据记录、评审与关闭交付。
限制:Forge 产物归 vault 所有,用 wiki init/resume/forge next/status 或 wiki config --effective 解析 vault,不要在代码仓库内创建 repo-local forge/、wiki/ 或 projects/ 文件夹。每个 vault 只有一个活动可变切片,不得绕过该不变量。评审须在独立上下文进行,禁止自评审。内部命令仅在阶段包、CLI 恢复提示或明确人工指令中出现时运行。失败时不要盲目重跑,用 wiki forge status、wiki checkpoint、wiki maintain 修复真相。编辑仓库技能文件后运行 bun run sync:full,再 bun run sync:local -- --audit,然后重启智能体会话。其他细节暂未提供。