单入口分级 Lane 开发控制架构

1. 设计结论

不复制 Loop Engineering 的完整多 Lane 控制面。只保留一个任务入口和一套事实模型，再用三档执行强度控制成本与风险。

2. AI 原生原则

AI 原生不是增加更多模型，而是让任务可由不同 Agent 无损接棒、让机器先验证机器能验证的事实，并让人只处理真正需要判断和授权的部分。

3. 任务分级

分级只决定需要多少任务契约、证据和审查，不改变 TaskID、状态文件和事实诚实原则。项目 Codex 在创建任务时选档；实现 Agent 不得自行降级。

4. 模型路由

模型路由不新增流程车道。任务记录 planner、executor、fallback、specialist verifier、reviewer 与升级阈值；换模型仍沿用同一 TaskID、独立分支、state.json 和 handoff.json，不重建任务上下文。

5. 共享端到端流程

三档共用这条主干，但 Mini A 使用 compact handoff 并可跳过独立审查；Lane C 会在范围、敏感操作、合并和部署位置增加人工 Gate。审查不通过时返回同一 TaskID 和分支。

6. 角色与状态提议权

每一步只有一个当前责任人。Agent 只能提交状态迁移事件，不能直接写 state.json；Dispatcher 是唯一状态写入者。状态表示流程阶段，owner 表示下一位必须行动的人。

7. 事实源与文件结构

CSV 继续作为全局任务索引；每个 TaskID 使用独立目录保存可审计事实。Agent 追加事件与证据，Dispatcher 单独生成状态快照，避免多个 Agent 竞争写同一个 JSON。

.agent-lane/
  tasks/
    fit20260806-001/
       task.md
       events.jsonl
       state.json
      handoff.json
      review.md
      verify-output.txt
      browser-evidence.json
      screenshots/

agent-dispatch.csv     # 全局索引，不保存完整证据
AGENTS.md              # 跨任务协作规则

分支：
luna/fit20260806-001-short-name
grok/fit20260806-001-short-name

8. state.json：机器状态投影

events.jsonl 保存状态变化事实，state.json 只回答“任务现在在哪一步、谁行动、证据在哪里”。摘要和讨论留在 Markdown，命令原始输出留在文本文件。

{
  "schemaVersion": 1,
  "stateVersion": 7,
  "lastEventId": "evt_fit20260806_001_007",
  "taskId": "fit20260806-001",
  "project": "jays-fitness",
  "lane": "A",
  "profile": "standard-a",
  "riskLevel": "normal",
  "taskRevision": 1,
  "status": "handoff_ready",
  "owner": "reviewer",
  "title": "Add editable custom exercise groups",
  "branch": "luna/fit20260806-001-custom-groups",
  "worktree": null,
  "scope": {
    "allowedPaths": [
      "app/components/training/",
      "tests/unit/ui/"
    ],
    "forbiddenPaths": [
      "worker/",
      "drizzle/",
      ".github/"
    ]
  },
  "acceptanceCriteria": [
    "Custom actions are grouped deterministically",
    "Existing planned actions are unchanged"
  ],
  "verification": {
    "required": [
      "npm.cmd run typecheck",
      "npm.cmd run test:unit"
    ],
    "result": "passed",
    "outputPath": "verify-output.txt"
  },
  "specialistVerification": {
    "required": true,
    "type": "browser",
    "status": "pending",
    "evidencePath": "browser-evidence.json"
  },
  "handoff": {
    "attempt": 1,
    "path": "handoff.json",
    "createdAt": "2026-08-06T10:30:00+08:00"
  },
  "review": {
    "verdict": "pending",
    "path": "review.md",
    "reviewedAt": null
  },
  "git": {
    "headCommit": "abc1234",
    "prUrl": null,
    "mergeCommit": null
  },
  "deployment": {
    "decision": "not_requested",
    "environment": null,
    "url": null,
    "productionCommit": null,
    "deployedAt": null,
    "verificationStatus": "not_started",
    "verifiedAt": null
  },
  "blocked": null,
  "createdAt": "2026-08-06T09:00:00+08:00",
  "updatedAt": "2026-08-06T10:30:00+08:00"
}

9. handoff.json：Agent 交接包

handoff.json 不面向人类写作，而是执行 Agent 给下一个 Agent 的确定性输入。它不复述完整任务，不保存聊天过程；只传递完成审查或继续实现所需的最小上下文。Mini A 使用 compact 版本，Standard A 与 Lane C 使用完整版本。

{
  "schemaVersion": 1,
  "kind": "implementation_handoff",
  "taskId": "fit20260806-001",
  "taskRevision": 1,
  "profile": "standard-a",
  "attempt": 1,
  "producer": {
    "agent": "luna-max",
    "role": "executor"
  },
  "consumer": {
    "role": "reviewer",
    "preferredAgent": "terra"
  },
  "repository": {
    "branch": "luna/fit20260806-001-custom-groups",
    "headCommit": "abc1234",
    "baseCommit": "def5678"
  },
  "result": "ready_for_review",
  "changes": [
    {
      "path": "app/components/training/CustomExerciseGroups.tsx",
      "changeType": "modified",
      "reasonCode": "acceptance_criterion_ac1"
    },
    {
      "path": "tests/unit/ui/custom-exercise-groups.test.ts",
      "changeType": "added",
      "reasonCode": "verification_for_ac1"
    }
  ],
  "acceptanceEvidence": [
    {
      "criterionId": "AC1",
      "status": "satisfied",
      "evidenceRefs": ["TEST:custom-groups:grouping-thresholds"]
    },
    {
      "criterionId": "AC2",
      "status": "satisfied",
      "evidenceRefs": ["TEST:training-plan:existing-order"]
    }
  ],
  "verification": [
    {
      "command": "npm.cmd run typecheck",
      "status": "passed",
      "exitCode": 0,
      "outputRef": "verify-output.txt#typecheck"
    },
    {
      "command": "npm.cmd run test:unit",
      "status": "passed",
      "exitCode": 0,
      "outputRef": "verify-output.txt#unit"
    }
  ],
  "scopeCheck": {
    "allowedPathsOnly": true,
    "forbiddenPathsTouched": [],
    "unexpectedPaths": []
  },
  "risks": [],
  "skippedChecks": [
    {
      "check": "browser_smoke",
      "reasonCode": "not_required_by_task_contract"
    }
  ],
  "reviewFocus": [
    "grouping_thresholds_2_4_5_6",
    "existing_action_order_stability"
  ],
  "requestedSpecialistChecks": [
    {
      "type": "browser",
      "scenarioId": "UI1",
      "viewports": ["412x915", "1440x900"],
      "evidenceOutput": "browser-evidence.json"
    }
  ],
  "nextAction": "independent_review",
  "createdAt": "2026-08-06T10:30:00+08:00"
}

agy 浏览器与多模态证据契约

agy 不返回泛化评价，而是为每个验收场景输出可定位、可复查的结构化结果。截图只是 evidenceRef，不能单独代表通过。

{
  "schemaVersion": 1,
  "kind": "browser_evidence",
  "taskId": "fit20260806-001",
  "taskRevision": 1,
  "producer": {
    "agent": "agy",
    "role": "specialist_verifier"
  },
  "target": {
    "url": "http://localhost:3000",
    "buildCommit": "abc1234"
  },
  "environment": {
    "browser": "chromium",
    "locale": "zh-CN",
    "timezone": "Asia/Singapore"
  },
  "scenarios": [
    {
      "scenarioId": "UI1",
      "viewport": "412x915",
      "status": "passed",
      "stepsCompleted": 5,
      "assertions": [
        {
          "assertionId": "UI1-A1",
          "status": "passed",
          "evidenceRefs": ["screenshots/UI1-mobile-result.png"]
        }
      ],
      "consoleErrors": [],
      "networkFailures": [],
      "notes": []
    }
  ],
  "visualChecks": {
    "overlapDetected": false,
    "overflowDetected": false,
    "unreadableTextDetected": false,
    "blankPrimarySurface": false
  },
  "result": "passed",
  "blockers": [],
  "nextAction": "terra_review",
  "createdAt": "2026-08-06T11:00:00+08:00"
}

10. 分层复核：从事实到判断

合理复核不是再让一个模型从头做一遍，而是先用便宜、确定性的检查排除机械错误，再把剩余判断交给独立上下文中的审查者。每份证据都绑定 taskRevision 与 headCommit；代码一变，相关结论就过期。

11. Lane C 与人工 Gate

Lane C 使用和 Lane A 相同的 TaskID、状态机与证据目录，但由 Codex 主导，并在敏感操作、合并和部署位置强制人工授权。执行者不得用“默认同意”跨越。

12. Token 控制规则

目标不是让 Agent 少思考，而是让每个 Agent 只消费完成自身职责所需的上下文。

13. 建议落地顺序

先建立最小闭环，再自动化。不要先写复杂 Hook 或状态服务。

14. Agent Dispatch 落地任务说明

本节是给本地 Agent Dispatch 项目的实现 Agent 与审查 Agent 使用的正式任务依据。目标是在现有静态调度台内增加 Lane 可见性和自动分类入口，不创建第二套调度台，不更换 CSV 事实源，也不要求浏览器直接执行本机命令。

本次实现范围

验收标准

验证与交接

node --check app.js

浏览器验证：
1. 使用旧 CSV 加载并确认“未分类”兼容行为。
2. 使用包含 mini-a、standard-a、lane-c 的数据检查卡片与详情。
3. 在 412x915 与 1440x900 视口检查布局和文本。
4. 检查复制命令中的中文、空格、双引号与单引号。
5. 确认 Lane C 派发被阻止，Mini/Standard 原流程仍可用。
6. 记录控制台错误检查结果。

交接必须包含：修改文件、逐项验收结果、验证输出、截图路径、残余风险和跳过项。