⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
forge
|
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
// README
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
forge ❯ 已修复。搜索代码库发现 3 处类似风险：
1. src/components/SourceCard.tsx:42 — 同样使用 gap-3（12px）
2. src/components/ActionCard.tsx:28 — padding 也是 12px
3. Feature Spec 中 StarredView 组件要求 gap: 16px，当前为 12px
要一并修复吗？
A) 全部修复
B) 选择性修复
Skill 清单
核心链路（9 个）
| 阶段 | Skill | 命令 | 职责 | 产出 |
|---|---|---|---|---|
| 讨论 | forge-brainstorm | /forge-brainstorm | 头脑风暴（4 模式 · 6 阶段 · 反谄媚 · 对抗性审查） | 思考文档 |
| 需求 | forge-prd | /forge-prd | 产品诊断 + Feature Spec 生成 | PRD.md + .features/feature-spec.md |
| 调度 | forge-dev | /forge-dev | 开发调度器，编排子技能；--full 一路到发布 | CONTEXT.md + RESEARCH.md + .forge/ 检查点 |
| 设计 | forge-design | /forge-design | 全栈设计（竞品 + 美学 + Token + UX 规则 + 评分） | DESIGN.md |
| 设计工作台 | forge-design-lab | /forge-design-lab | 真 token 真像素骨架上定布局/密度（七层审查 + 保存直写 + token 同源导出） | 页面包 + tokens.css + DESIGN.md token 表 |
| 设计实现 | forge-design-impl | /forge-design-impl | 设计转代码（反 AI 模板 + Token 驱动 + 原子提交） | 样式代码 |
| 工程 | forge-eng | /forge-eng | 工程实现（Worktree + TDD + 逐场景自验） | ENGINEERING.md + 代码 |
| QA | forge-qa | /forge-qa | 验收计划 → 测试 → 报告 → 举一反三（只测不修） | QA 验收报告 |
| 审查 | forge-review | /forge-review | 代码审查（测试捕获不到的结构性问题） | 审查结论 + 修复 |
| 发布 | forge-ship | /forge-ship | 合并 + 测试 + CHANGELOG + PR | PR / 合并上线 |
辅助技能（6 个）
| Skill | 命令 | 职责 |
|---|---|---|
| forge-bugfix | /forge-bugfix | 系统性 Bug 修复流水线（P0-P8：根因铁律 + 独立 worktree + TDD + 双层验收 + 多会话防撞车） |
| forge-status | /forge-status | 并行会话巡检与清理（扫 .forge/active.md，按硬信号判活/死，不用时间戳启发式） |
| forge-doc-release | /forge-doc-release | 发布后文档同步（README/ARCHITECTURE/CHANGELOG 对齐已发布内容） |
| forge-doc-policy | /forge-doc-policy | 文档治理规范（doc-paths.md 真相源白名单 + frontmatter schema + init-project.sh 脚手架） |
| forge-feature-doc | /forge-feature-doc | 需求设计文档：每个功能一份给人看的设计文档（待拍板置顶、先图后字、只写当前设计、末尾关键改动），配出图脚本和上线前检查；forge 各阶段收尾时同步，review / ship 当门禁 |
| forge-fupan | /forge-fupan | 复盘 v3：Workbench 门禁（独立会话页确认知识点和深度）→ 调研产出复盘文档；账本（learnings.jsonl）作副产出，开工回放 + 复发检测 |
每个 Skill 怎么运转
每个 Skill 一张结构图：阶段、门禁、回退和产出。点图进 Skill 目录，看说明和完整的 SKILL.md。
// HOW IT'S BUILT
KEY FILES