northseadl/norix-skills/agent-task-orchestration

用户 (Commander) ─── 给出初始需求 + 约束 ─── 可随时介入
       │
       ▼
你 (Strategist) ── 用户的战略代理 ── 拆解/监控/验收/决策
       │
       ▼
Lieutenant (dispatch.mjs) ── 自动重试/恢复/调度
       │
       ▼
Builder (Codex/Claude) ── 执行原子任务 ── 不做架构决策

用户需求
  │
  ▼
┌─────────┐   ┌─────────┐   ┌──────────┐   ┌────────────────────┐
│ Analyze │──→│Decompose│──→│ Dispatch │──→│ Autonomous Loop    │
│  分析    │   │  拆解    │   │  派发     │   │  监控 → 评估 → 决策│
└─────────┘   └─────────┘   └──────────┘   └────────────────────┘
     ↑                                           │
     │              ┌────────────────────────────┘
     │              ▼
     │     ┌─ 决策分支 ────────────────────────────┐
     │     │ 全部成功 → 汇总 → 用户需求满足?        │
     │     │   ├─ 是 → 最终报告 → 结束              │
     │     │   └─ 否 → 规划下一批次 → Decompose     │
     │     │ 部分失败 → resume --retry-failed       │
     │     │ 全部失败 → 根因分析 → 报告用户          │
     └─────┴────────────────────────────────────────┘

## T{序号} · {任务名称}
 
-**Agent**: {执行者标识，如 codex-1, claude-1}
-**Engine**: codex 或 claude（可选，未指定则继承 --engine 默认值）
-**范围**: {涉及的文件/模块，精确到目录}
-**输入**: {前置条件，包括依赖任务的产出物}
-**交付物**: {明确的输出文件列表}
-**验收**:
  -[ ] {可自动验证的条件}
  -[ ] {可人工验证的条件}
-**依赖**: {无 / ← T{N} 完成}
-**预估**: {S/M/L — Small: <30min, Medium: 30-60min, Large: 60-120min}

T1 (基础设施) ──→ T3 (Feature A)
               ──→ T4 (Feature B)
T2 (API 契约)  ──→ T3 (Feature A)
T3 + T4        ──→ T5 (集成测试)
无依赖立即启动: T1, T2

# 安装依赖
cd agent-task-orchestration && npm install
 
# 预览执行计划（不实际调度）
node scripts/dispatch.mjs ./tasks/ --dry-run
 
# 并行调度，全自动模式（自动打开 Dashboard）
node scripts/dispatch.mjs ./tasks/ --parallel --approval-mode full-auto
 
# 使用 Claude Code 引擎
node scripts/dispatch.mjs ./tasks/ --parallel --engine claude --approval-mode full-auto
 
# 查询运行状态（零开销）
cat ./tasks/.dispatch-logs/{runId}/signal

1. cat signal
   ├─ RUNNING           → sleep 60s → 回到 1
   ├─ COMPLETED         → cat digest.txt → 进入 EVALUATING
   ├─ ATTENTION (failed) → cat digest.txt → 评估: retry/skip/report
   ├─ ATTENTION (token)  → 决策: 等待/终止（通常等待——不要因为超预算就中断）
   ├─ FAILED            → cat digest.txt → 决策: resume/skip/report
   └─ FATAL             → cat digest.txt → 报告用户

# Step 0: Git 快照（必须执行 — 确保变更可追溯可回滚）
git add -A && git commit -m "feat: 批次{runId}完成 — {简要摘要}"
 
# Step 1: 读取结构化结果
cat {taskDir}/.dispatch-logs/{runId}/summary.json
 
# Step 2: 检查代码变更范围
git diff --stat HEAD~1
 
# Step 3: 构建验证（必须执行 — 从 AGENTS.md 获取构建命令）
# 读取 AGENTS.md 中的 "变更后检查清单" 段落，执行对应命令
# 例如: cd server && go build ./... && go test ./...
# 例如: cd apps/web && pnpm build
# 审计/文档类批次可跳过

## 批次评估: {runId}
 
| Task | 状态 | 耗时 | Token | 代码变更 |
|:---|:---|:---|:---|:---|
| T1 | ✅ | 12m | 542K/13K | +30/-5 |
| T2 | ✅ | 34m | 1.08M/13K | +120/-40 |
 
总结: {N} 成功 / {N} 失败 / 变更 +{N}/-{N} 行
构建: ✅/❌

needs_fulfilled >= 100% AND quality_ok?
  └─ YES → FINAL_REPORT (结束)
  └─ NO  → 还有什么没做?
              ├─ 明确的下一步任务 → PLAN_NEXT_BATCH
              ├─ 需要用户澄清方向 → ASK_USER
              └─ 失败需要修复     → RESUME_RETRY
 
任务失败?
  ├─ 可重试 (Lieutenant 已重试 3 次仍失败) → 修改 task spec → DISPATCH
  ├─ 任务设计有误 → 修改 task spec → DISPATCH
  └─ 根本性阻塞 → REPORT_BLOCKER (告知用户)