任务系统

中等及以上复杂度的任务会创建持久化任务目录。这是 CCG 实现跨会话状态恢复和阶段门控的核心机制。

目录结构

.ccg/tasks/add-jwt-auth/
├── task.json         # 状态、策略、当前阶段、门控
├── requirements.md   # 增强后的需求文档
├── plan.md           # 审批通过的实现计划
├── context.jsonl     # 子 Agent 需要的 spec 文件列表
├── review.md         # 审查结果
└── research/         # 持久化的研究发现

task.json

任务系统的核心文件，记录任务的完整状态：

{
  "id": "add-jwt-auth",
  "status": "in_progress",
  "strategy": "full-collaborate",
  "phase": "4-implementation",
  "gate": "approved",
  "created": "2026-05-16T10:00:00Z",
  "updated": "2026-05-16T11:30:00Z",
  "classification": {
    "type": "feature",
    "complexity": "L",
    "domain": "backend",
    "risk": "high"
  }
}

requirements.md

full-collaborate 策略在双模型分析后生成的增强需求文档，包含：

原始用户需求
Codex 的后端分析补充
Gemini 的前端分析补充
识别出的约束和风险

plan.md

经过 HARD STOP 人类审批后的实现计划，包含：

实施步骤
文件修改清单
Builder 分工（如有 Agent Teams）
验收标准

context.jsonl

子 Agent 注入列表，每行一个 JSON 对象：

{"type": "spec", "path": ".ccg/spec/backend/index.md"}
{"type": "spec", "path": ".ccg/spec/guides/auth.md"}
{"type": "plan", "path": ".ccg/tasks/add-jwt-auth/plan.md"}

subagent-context.js Hook 读取此文件，将对应内容注入 codeagent-wrapper 和 Team Builder 的 prompt 中。

review.md

双模型交叉审查的结果，按严重程度分级：

Critical — 必须修复
Warning — 建议修复
Info — 可选优化

阶段关卡（Phase Gates）

任务从创建到完成经历多个阶段，部分阶段有强制 HARD STOP：

Phase 1: 上下文收集
    ↓
Phase 2: 分析（双模型并行）
    ↓
Phase 3: 计划生成
    ↓
  ██ HARD STOP — 等待人类审批 ██
    ↓
Phase 4: 实施（Agent Teams / 直接编码）
    ↓
Phase 5: 验证（质量关卡）
    ↓
Phase 6: 审查（双模型交叉）
    ↓
  ██ HARD STOP — 确认结果 ██
    ↓
Phase 7: 完成

状态恢复机制

任务系统与 Hook 引擎配合实现跨会话状态恢复：

每轮注入 — workflow-state.js 每轮读取 task.json，将状态注入到 Claude 的上下文中
压缩恢复 — 上下文被压缩后，session-start.js 重新注入完整任务状态
新会话恢复 — 打开新会话时，session-start.js 检测未完成任务并注入

会话 1: 创建任务 → 分析 → 计划 → HARD STOP
    （用户离开）

会话 2: session-start.js 检测到未完成任务
    → 注入 task.json + plan.md
    → Claude 知道"上次停在 HARD STOP，等待审批"
    → 用户说"继续" → 进入实施阶段

任务生命周期

状态	含义
`created`	任务目录已创建
`in_progress`	正在执行中
`hard_stop`	等待人类决策
`completed`	正常完成
`failed`	执行失败
`cancelled`	用户取消

哪些策略创建任务目录

策略	创建任务目录
`direct-fix`	否
`quick-implement`	否
`guided-develop`	是
`full-collaborate`	是
`debug-investigate`	是
`refactor-safely`	是
`deep-research`	是
`optimize-measure`	是
`review-audit`	否（结果直接输出）
`git-action`	否