mb-harness

mb-harness — Harness 工程配置

• **用途：**定义仓库周围的执行 Harness，包括命令、门禁和支持并行的工作流。
• **适用场景：**在进行自主或多会话工作前，仓库需要更严格的 Agent 防护措施。
• **输入：**仓库根目录，以及项目的规范构建、测试和 lint 命令。
• **输出：**已记录的质量门禁、可选的 Codex 配置，以及更安全的 Agent 执行 Harness。

目标

将仓库打造为可靠的 Agent「Harness」：

• 明确的入口点（AGENTS.md）
• 可复现的命令（构建／测试／lint）
• 机械化检查（CI + MB lint）
• 支持并行的工作流（worktree）

流程

1) Codex 项目配置（可选但推荐）

如果使用 Codex：

1. 创建 .codex/ 文件夹。
2. 根据 assets/codex-config.toml 创建 .codex/config.toml。

用法示例：

• 默认配置（编码）：codex
• 深度审查：codex --profile deep-review

2) 记录质量门禁

在 AGENTS.md 中（保持简短）列出规范命令（例如）：

• 安装依赖
• lint／类型检查
• 单元测试
• 端到端测试

如果仓库包含 UI 或浏览器流程，请明确记录：

• Playwright 命令
• agent-browser／浏览器 MCP 路径（如果可用）
• 截图／视频／跟踪文件的存储位置
• 被视为发布关键流程的项目

如果仓库缺少这些内容，请添加最精简的脚本／Make 目标。

3) Worktree 工作流（并行 Agent）

如果多个 Agent 并行工作：

• 为每个 Agent 创建 worktree，以避免文件冲突
• 通过门禁后再合并

示例：

git worktree add ../wt-agent-1 -b agent-1

4) 添加确定性的 Memory Bank 门禁

如果尚未添加，请安装打包的 Memory Bank 门禁资源：

• 从 mb-garden/assets/mb-lint.mjs 安装 scripts/mb-lint.mjs
• 从 mb-garden/assets/mb-doctor.mjs 安装 scripts/mb-doctor.mjs
• 为默认健康检查门禁添加 CI 工作流覆盖

mb-garden/assets 路径是当前打包资源的位置，并不代表 doctor 职责在概念上的归属。mb-lint 负责结构／机械层面的规范检查。mb-doctor 在 mb-lint 基础上检查工作流／自主执行准备情况。日常入队前健康检查应运行默认 mb-doctor。只有在 JSON 任务队列已存在后才运行严格模式：在 /prd-to-tasks 之后、/autonomous 内调度器执行之前，或在队列已准备就绪时运行 /autopilot 之前：

node scripts/mb-lint.mjs
node scripts/mb-doctor.mjs --strict

Harness 应将缺少 task.tier 视为阻断性策略错误。任务状态只能通过 .memory-bank/tasks/index.json 和已索引的 TASK-*.task.json 记录以 JSON 格式保存；不支持 backlog.md、Markdown 任务卡，以及旧版 risk／risk.level 路由。

4.1) UI 项目的浏览器验证

如果产品有 UI：

• 优先使用 Playwright／agent-browser／由 CDP 驱动的检查，而不是「手动看起来没问题」
• 将产物（截图、视频、跟踪文件）保存到 .tasks/TASK-XXX/
• 在 .memory-bank/testing/index.md 中记录规范的浏览器验证命令

5) 可选：技能评估 Harness

如果你频繁迭代技能：

• 使用 codex exec --json 运行和确定性评分器（参见 OpenAI 评估指南）

完成标准

• .codex/config.toml 存在（如果使用 Codex），且包含编码和审查配置。
• AGENTS.md 列出了质量门禁命令。
• 仓库记录了使用 worktree 的方法。
• Memory Bank lint 已安装并通过检查。
• UI 仓库记录了由浏览器驱动的验证路径。