用途:为仓库建立智能体执行护栏(harness),把仓库变成可靠、可复现的运行环境,便于自主或多会话工作。
主要能力:明确入口(AGENTS.md);可复现命令(build/test/lint);机械检查(CI 与 MB lint);并行安全工作流(worktrees);可选 Codex 配置;UI 项目的浏览器验证路径。
使用方式:
- 可选 Codex 配置:创建 .codex/ 目录,从 assets/codex-config.toml 生成 .codex/config.toml。用法示例:默认 profile(coding)用 codex;深度审查用 codex --profile deep-review。
- 在 AGENTS.md 中简短列出规范命令:安装依赖、lint/typecheck、单元测试、e2e 测试。若有 UI 或浏览器流程,需记录 Playwright 命令、agent-browser/浏览器 MCP 路径(如可用)、截图/视频/trace 存放位置、发布关键流程。缺失时补充最小 scripts/Make 目标。
- 并行智能体使用 worktree:每个智能体一个 worktree 避免文件冲突,通过门禁后再合并。示例:git worktree add ../wt-agent-1 -b agent-1
- 安装确定性 Memory Bank 门禁:从 mb-garden/assets/mb-lint.mjs 与 mb-garden/assets/mb-doctor.mjs 复制到 scripts/,并纳入 CI。运行:node scripts/mb-lint.mjs;node scripts/mb-doctor.mjs --strict。mb-lint 负责结构/机械卫生,mb-doctor 负责工作流/自主就绪度。默认 mb-doctor 用于常规入队前健康检查;strict 模式仅在 JSON 任务队列存在后使用(/prd-to-tasks 之后、/autonomous 内调度器执行前,或队列已就绪时的 /autopilot 前)。缺失 task.tier 应视为阻塞性策略错误。任务状态仅通过 .memory-bank/tasks/index.json 与索引的 TASK-*.task.json 记录,不支持 backlog.md、markdown 任务卡及旧 risk/risk.level 路由。 4.1) UI 项目浏览器验证:优先 Playwright/agent-browser/CDP 驱动检查,而非“手动看起来没问题”;产物(截图、视频、trace)存入 .tasks/TASK-XXX/;在 .memory-bank/testing/index.md 记录规范浏览器验证命令。
- 可选技能评估 harness:若频繁迭代技能,使用 codex exec --json 运行加确定性评分器。
完成标准:存在 .codex/config.toml(若用 Codex)且含 coding 与 review profile;AGENTS.md 列出质量门禁命令;仓库有 worktree 文档路径;Memory Bank lint 存在且通过;UI 仓库有文档化的浏览器驱动验证路径。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;部分步骤为可选或条件性(如 Codex、UI 项目、技能评估)。