Quality-Loop技能：给 AI Agent 装上质量闭环（附下载）

Step 1: 加载或创建 Task Spec（P）
  检查 specs/{task_type}.spec.json 是否存在
    ├── 存在 → 读取 spec
    └── 不存在 → 引导创建："这个任务检查什么？失败时如何响应？"
              → 生成 spec JSON → 保存

Step 2: 执行任务 + 记录 Trace（D）
  按正常流程执行，同步记录：
  - 环境快照（Python/Node 版本、Git HEAD）
  - 使用的工具和模型
  - 逐步步骤（动作、目标、结果、耗时）
  - 输出物（文件、字数、外部动作）

Step 3: 运行检查引擎（C）
  加载 task spec → 依次执行 L1→L2→L3 规则
  每条规则返回: { rule_id, passed, detail, evidence }

Step 4: 分析结果 → 决定响应（A）
  全部通过 → Step 5
  L1 失败 → 自动重试（max=3次）
  L2 失败 → 展示审查结果 + 方案选择
  L3 失败 → 展示评分 + 建议

Step 5: 交付审查报告
  全部通过：✅ 简洁摘要 + 产物路径
  有问题：⚠️ 详细报告 + 根因 + 建议 + 选项

评分标准 (1-5):
1 = 不可用，严重错误或完全偏离
2 = 有框架但内容空洞
3 = 内容合格，无重大错误
4 = 内容准确，有一定深度
5 = 专业水准，内容精准，有独到见解

L1 失败 → 自动重试（不打扰用户）
  ├── 重试通过 → 静默继续
  └── 重试耗尽 → prompt_user（展示问题 + 选项）

L2 失败 → prompt_user（展示审查结果 + 方案选择）
  └── 可选 degrade：自动执行降级策略

L3 失败 → 始终 prompt_user

{
  "task_type": "morning-brief",
  "checks": {
    "L1_format": {
      "rules": [
        {"type": "file_exists", "path": "morning-briefs/YYYY-MM-DD/brief.md"},
        {"type": "sections_present", "required": ["时事热点","AI论文","行业应用","天气","思维模型"]}
      ]
    },
    "L2_logic": {
      "rules": [
        {"type": "word_count_range", "min": 1500, "max": 5000},
        {"type": "overlap_with_yesterday", "max": 0.30},
        {"type": "section_min_words", "section": "思维模型", "min": 200}
      ]
    }
  },
  "actions": {
    "on_fail": [
      {"level": "L1", "action": "retry", "max": 3},
      {"level": "L2", "action": "prompt_user", "options": ["追加搜索后重试","跳过","手动介入"]}
    ]
  }
}

✅ 质量闭环通过
   · L1 格式检查: 2/2 通过
   · L2 逻辑检查: 3/3 通过
   · Trace 已存档: memory/traces/2026-06-03_morning-brief.json
   产物就绪: morning-briefs/2026-06-03/brief.md (3240 字)

⚠️ 质量闭环发现问题

   L2 逻辑检查: 2/3 通过 (1项问题)
   ┌─ [FAIL] overlap_with_yesterday: 重叠度 42% > 30%
   │  原因: 今日搜索结果与昨日高度重复
   │  建议方案:
   │     [1] 追加一轮新关键词搜索后重试
   │     [2] 跳过此检查接受当前版本
   │     [3] 手动介入修改
   └─ 请选择 (1/2/3):

{"type": "eslint_passes", "description": "代码无 lint 错误"},
{"type": "typescript_no_errors", "description": "TypeScript 编译通过"},
{"type": "test_coverage_min", "min": 80, "description": "测试覆盖率 ≥ 80%"},
{"type": "file_count_match", "expected": 3, "description": "生成了预期数量的文件"}

git clone https://github.com/jafferchong/quality-loop.git

{
  "task_type": "my-code-review",
  "checks": {
    "L1_format": {
      "rules": [
        {"type": "file_exists", "path": "src/output.py"},
        {"type": "file_not_empty", "path": "src/output.py"}
      ]
    },
    "L2_logic": {
      "rules": [
        {"type": "word_count_range", "min": 50, "max": 2000}
      ]
    }
  },
  "actions": {
    "on_fail": [
      {"level": "L1", "action": "retry", "max": 2}
    ]
  }
}