用途:把软件交付当作一个闭环工程组织来运行,而非单次编码提示。流程为愿景→设计→Issue→分支→PR→对抗式评审→证据→合并→记忆→下一个Issue。Codex 充当协调者,按步骤派生受范围约束的子智能体。
主要能力:以 Issue 为工作单元,每次变更从 Issue 开始、以带证据的合并 PR 结束;用 Worktree 隔离智能体,禁止直接改 main/master;每个 PR 由 2–3 名冷启动评审者做对抗式评审,默认假设实现有问题;证据门禁覆盖前端截图与 Playwright、后端测试与 curl 追踪、数据库迁移与回滚、CI 日志、评审报告;记忆作为项目状态而非聊天记录,稳定结论写入 docs/ 与 memory/。
使用方式:以 $ai-engineering-harness 调用后,协调者读取项目根目录的 CLAUDE.md、AGENTS.md、PROJECT_STATUS.md、docs/INDEX.md,缺失则运行 workflows/00-project-bootstrap.md。若存在 .dashboard/,先执行 bash scripts/dashboard.sh 使仪表盘在 :4321 运行。按关键词路由到兄弟技能,如 agent/LLM/chatbot 走 $build-agent-app,landing page/GSAP 走 $frontend-creative。
适用场景:启动、接管或抢救非平凡产品;仓库尚无操作系统(无 docs/INDEX.md、Issue/PR 模板、ADR 日志、证据目录);多智能体或多 Worktree 共用同一仓库需共享契约;质量下滑、PR 无评审即合并;从 PRD/MVP 规格引导新项目。
限制:一次性脚本、抛弃型原型或单文件修改应改用普通编码技能,本框架对它们是额外开销。CI 为红灯时流程阻塞,不得进入或越过评审,须停留在 workflows/04-ci-recovery.md 直至绿灯。涉及数据丢失或重构的 schema/迁移、认证与权限模型变更、生产密钥或外部付费 API、发布与版本号、破坏 ADR 的决策,均需人类审批门禁并暂停循环。禁止无 Issue 写代码、直接编辑 main/master、无两份评审报告加 CI 绿灯加完整证据即合并、为每个智能体批量加载 docs/、以本地测试通过为由跳过证据、自动解决多智能体冲突、把聊天历史当项目记忆、同一智能体既实现又评审同一 PR、合并与本地代码重复的 PR。
其他事实:仓库布局、18 个智能体角色、10 个工作流、上下文分级 L0–L3、证据门禁清单、记忆与技能演化机制等细节见原文;具体安装命令与收费信息暂未提供。