Skip to content
zxpmail edited this page Jun 27, 2026 · 5 revisions

ReqForge(Forge)

当前版本:v1.48.6(2026-06-27)
主文档README 中文 · README English · CHANGELOG

v1.48.6 亮点:mockup 验收后冻结根目录 DESIGN.mdGoogle design.md 格式);dev-builder / code-review 优先读 token,不再从 Brief 猜色值。


ReqForge 是把 AI 编码助手变成可交付产品开发操作系统的开源 Harness(不是零散 prompt):

  • 需求 → Spec → Plan → 实现 → 审查 → 发布
  • 适配 Claude CodeCursorOpenCodeGemini CLI
  • 14 个 Skill + 钩子 + 记忆 + 进化,让输出可验证、可回滚

一句话:模型是 CPU,Harness 是 OS——编排、记忆、护栏、验收,目标是把产品做出来,而不是聊完就散。


快速开始

  1. 克隆 zxpmail/ReqForge
  2. 推荐pnpm forge-install <client> --target /path/to/my-appclaude-code | cursor | opencode | gemini-cli
    或手动复制 adapters/<client>/ 下对应目录到用户项目根
  3. 陌生领域可选先跑 /domain-mapperdomain-map.md
  4. /product-spec-builderProduct-Spec.md(0-to-1 默认 Multi-Stakeholder Review + 批判 Gate)→ 确认后再 /dev-planner/dev-builder

详细安装见 README 安装与使用


v1.48 要点(摘要)

主题 说明
DESIGN.md 冻结 design-maker → UI-Spec.md + DESIGN.md;与 OpenSpec changes/.../design.md 分工不同
审查 action 三分法 code-review finding:auto-fix / ask-user / no-op(v1.48.5)
Spec 蒸馏模式 /product-spec-builder 可选 Distillation(v1.48.3)
forge-install Windows 自动检测修复(v1.48.4)
Multi-Stakeholder Review 写 Spec 前四视角扫描 + 批判 Gate
/domain-mapper 领域研究 → domain-map.md
2.5 层 design-maker → dev-builder 模型间中间表示(结构 + token)
发版守门 维护者:pnpm forge-smoke

核心 Skill 命令

阶段 命令 产出
模糊路由 /request-dispatcher 推荐目标 Skill
领域研究(可选) /domain-mapper domain-map.md
需求 /product-spec-builder Product-Spec.md
设计(可选) /design-brief-builder · /design-maker Design-Brief.md · 设计稿 + UI-Spec.md + DESIGN.md
存量变更 /change-manager changes/<name>/
计划 /dev-planner DEV-PLAN.md
开发 /dev-builder 代码 + memory/
调试 /bug-fixer 修复(可配合 pnpm forge-bug-fix
审查 /code-review 审查报告
发布 /release-builder 发布清单

文档导航(仓库内)

文档 链接
Harness 成熟度自检 harness-maturity-checklist.md
七层对照 agent-harness-seven-layer-map.md
Loadout 场景选型 loadout-scenarios.md
Workflow Cookbook workflow-cookbook.md
Agent 执行纪律(8 条) session-execution-discipline.md
OpenSpec 对照 openspec-comparison.md
平台合规(CI/fork) platform-compliance.md

完整对照索引见 README → 参考与对照


Wiki 维护说明

  • 本页源稿:docs/github-wiki/Home.md(随版本 bump 时一并更新)
  • 同步命令:pnpm forge-wiki-sync(详见 docs/github-wiki/README.md

ReqForge · MIT · GitHub

Clone this wiki locally