fix-engine

# 修复引擎

**所有者:** 仅子协调器

## 职责

1. 读取 section_path 中的 mini-prd.md
2. 将验收标准转换为 checklist.md（markdown 复选框格式）
3. 编排：executor → validator → (失败则重试)
4. 每次验证后更新 checklist.md 的复选框状态
5. 更新 meta.yaml 中的进度摘要
6. 跟踪尝试次数并累积失败上下文
7. 超过最大重试次数时准备详细错误报告

## 检查清单创建

从 mini-prd.md 的验收标准生成 checklist.md（markdown 格式）：

```markdown
## 认证模块检查清单

- [ ] 用户可以使用邮箱/密码注册
- [ ] 登录时签发 JWT 令牌
- [ ] 受保护路由拒绝无效令牌
- [ ] 刷新令牌轮换正常工作

**进度: 0/4**
```

每次 validator 返回结果后，更新对应的复选框：
- 通过的检查项：`- [x]`
- 失败的检查项：`- [ ]`

同时更新底部的进度摘要。

## 执行循环

```
attempt = 0
max_attempts = 3

while attempt < max_attempts:
    if attempt == 0:
        # 使用 executor agent 实现 .task/mini-prd.md
        call executor agent to implement .task/mini-prd.md
    else:
        call executor(task: "fix", failures: last_failures, previous_attempts: history)

    # 使用 validator agent 检查 .task/checklist.md
    result = call validator agent to check against .task/checklist.md

    # 更新 checklist.md
    update_checklist(result.checkbox_states)

    # 更新 meta.yaml 进度
    progress = f"{result.passed_count}/{result.total_count}"
    update_meta_yaml(section_id, progress: progress)

    if result.all_passed:
        # 完成协议：提交所有更改
        git add -A
        git commit -m "${section_name}: ${summary}

        - ${change_1}
        - ${change_2}

        🤖 Generated with InfiStack"

        # 更新状态文件（最后一步）
        update_meta_yaml(section_id, status: "completed")
        return SUCCESS

    history.append({
        attempt: attempt,
        failures: result.failures,
        executor_notes: executor.notes,
        code_snippets: result.relevant_code
    })

    attempt++

return ESCALATE(error_report: history)
```

## 完成协议

当所有检查清单项通过时：

1. 暂存所有更改：`git add -A`
2. 提交并附带结构化消息：
```bash
git commit -m "${section_name}: ${summary}

- ${change_1}
- ${change_2}

🤖 Generated with InfiStack"
```
3. 写入 COMPLETE 到状态文件
4. 只有在此之后才发出完成信号

## 错误报告格式

```yaml
error_report:
  section_id: "auth-module"
  attempts: 3
  final_failures:
    - check_id: check-2
      expect