菜单
根据不清洁状态类型，执行自动修复或回滚，恢复到清洁状态
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
EnjoyHarness 唯一强制入口，初始化全局状态、文件体系、技能注册表
配置文件读取和验证技能，确保用户配置正确且完整
全流程自动执行超级组合技能，编排所有16个基础技能，从用户需求到完整交付的全自动化流程
头脑风暴技能，在实现前探索用户意图、需求和设计，防止返工
实施计划执行技能，逐任务执行实施计划，支持检查点、错误恢复和进度跟踪
10倍产能提效超级组合技能，通过并行执行、智能调度、优化策略实现10倍开发效率提升
| name | harness-recover-clean-state |
| description | 根据不清洁状态类型，执行自动修复或回滚，恢复到清洁状态 |
| trigger_words | ["harness-recover-clean-state","恢复清洁状态","clean state recovery"] |
| priority | HIGH |
| dependencies | ["harness-check-clean-state"] |
| version | v1.0.0 |
根据清洁状态检查结果，执行自动修复或回滚，恢复到清洁状态。
核心职责：
GLOBAL_STATE.md（获取当前功能）工具: Read
文件: .EnjoyHarness/GLOBAL_STATE.md
Token 消耗: ~200 tokens
目的: 获取 current_feature 字段（当前功能ID）
问题类型:
- Linter 警告
- Git 未提交更改
- 文档未更新
- TODO/FIXME 遗留
修复流程:
1. 自动修复 Linter 警告
工具: Bash
命令: make lint --fix（或项目特定修复命令）
Token 消耗: ~1000 tokens
2. 自动提交 Git 更改
工具: Bash
命令: git add . && git commit -m "fix: auto-fix linter warnings"
Token 消耗: ~200 tokens
3. 更新文档
工具: Edit
文件: .EnjoyHarness/EVENT_LOG.md
追加: SESSION_END 事件
Token 消耗: ~100 tokens
4. 标记 TODO/FIXME（可选）
工具: Edit
处理: 将 TODO/FIXME 添加到临时清单，下次会话处理
Token 消耗: ~100 tokens
总 Token 消耗: ~1400 tokens
问题类型:
- 测试失败
- 架构违规
- 功能未标记完成
- 端到端验证失败
修复流程:
1. 尝试自动修复测试失败
工具: Bash + AI 分析
方法:
- 分析测试失败日志
- 定位失败原因
- 修改代码修复问题
Token 消耗: ~3000 tokens
2. 重新运行测试
工具: Bash
命令: make test
Token 消耗: ~1000 tokens
3. 如果测试仍然失败:
- 失败次数 +1
- 如果失败次数 < 3 → 重试修复（返回步骤 1）
- 如果失败次数 ≥ 3 → 触发回滚（步骤 3）
4. 如果测试通过:
- 更新 feature_list.json（passes: true）
- 更新 EVENT_LOG.md
- 继续下一步
总 Token 消耗: ~6000 tokens（含重试）
问题类型:
- 无法编译
- 文件损坏
- 依赖缺失
修复流程:
1. 立即回滚到上一个清洁提交
工具: Bash
命令:
- 查找上一个清洁提交：git log --grep="clean-state: true" --oneline -1
- 如果没有清洁提交，使用最近一次成功构建的提交：git log --grep="BUILD_SUCCESS" --oneline -1
- 如果都没有，使用最近一次提交：git log --oneline -1
2. 执行回滚
工具: Bash
命令: git reset --hard {last-clean-commit}
Token 消耗: ~500 tokens
3. 记录回滚事件
工具: Edit
文件: .EnjoyHarness/EVENT_LOG.md
追加内容:
- 时间戳：2026-03-28T12:35:00
- 事件类型：ROLLBACK
- 回滚原因：CRITICAL_ISSUES
- 回滚提交：{commit-hash}
Token 消耗: ~100 tokens
4. 验证回滚结果
工具: Bash
命令: make build
Token 消耗: ~500 tokens
5. 如果回滚失败:
- 触发 harness-handle-failure 或标记真实阻塞
- 仅在无法继续自动恢复时升级 harness-escalate-to-human
- 记录到 EVENT_LOG.md（ESCALATION | ROLLBACK_FAILED）
总 Token 消耗: ~1100 tokens
工具: Skill
技能: harness-check-clean-state
Token 消耗: ~3400 tokens
目的: 验证修复或回滚是否成功
如果检查结果 == CLEAN:
- 输出"清洁状态已恢复"
- 继续下一步（触发 harness-track-feature-progress）
如果检查结果 != CLEAN:
- 失败次数 +1
- 如果失败次数 < 3 → 返回 Step 2（重新修复）
- 如果失败次数 ≥ 3 → 判定是否进入真实阻塞升级（Step 5）
工具: Skill
技能: harness-escalate-to-human
参数:
- 原因：修复失败 3 次
- 问题类型：MINOR/MODERATE/CRITICAL
- 当前功能：{current_feature}
记录到 EVENT_LOG.md:
- 时间戳：2026-03-28T12:40:00
- 事件类型：ESCALATION
- 原因：修复失败 3 次
- 需要真实阻塞升级
Token 消耗: ~200 tokens
必须满足：
harness-check-clean-state（有检查结果）如果前置条件不满足：
成功标准：
EVENT_LOG.md失败情况：
检测: 失败次数 ≥ 3
处理:
1. 记录到 EVENT_LOG.md（ERROR | FIX_FAILED_3_TIMES）
2. 判定为真实阻塞后触发 harness-escalate-to-human
3. 退出自动恢复循环
检测: git reset 失败
处理:
1. 记录到 EVENT_LOG.md（ERROR | ROLLBACK_FAILED）
2. 判定为真实阻塞后触发 harness-escalate-to-human
3. 退出自动恢复循环
检测: git log --grep="clean-state: true" 返回空
处理:
1. 使用最近一次成功构建的提交
2. 如果也没有，使用最近一次提交
3. 记录警告到 EVENT_LOG.md（WARNING | NO_CLEAN_COMMIT_FOUND）
修复成功:
- 触发 harness-check-clean-state（重新检查）
- 如果通过 → 触发 harness-track-feature-progress（标记完成）
修复失败:
- 默认返回 harness-handle-failure / 自动恢复
- 仅真实阻塞时触发 harness-escalate-to-human
触发时机:
- harness-check-clean-state 检测到不清洁状态
- 用户显式调用："恢复清洁状态"
必须依赖:
- harness-check-clean-state（检查结果）
轻微问题修复（MINOR_ISSUES）:
- Read GLOBAL_STATE.md: ~200 tokens
- 自动修复 Linter: ~1000 tokens
- 自动提交 Git: ~200 tokens
- 更新文档: ~200 tokens
- 重新检查: ~3400 tokens
总计: ~5000 tokens
中等问题修复（MODERATE_ISSUES）:
- 分析测试失败: ~3000 tokens
- 修改代码: ~3000 tokens
- 重新运行测试: ~1000 tokens
- 重新检查: ~3400 tokens
总计: ~10400 tokens（含重试）
严重问题回滚（CRITICAL_ISSUES）:
- Read GLOBAL_STATE.md: ~200 tokens
- 查找清洁提交: ~200 tokens
- 执行回滚: ~500 tokens
- 验证回滚: ~500 tokens
- 重新检查: ~3400 tokens
总计: ~4800 tokens
输入:
问题类型: Linter 警告（格式问题）
失败项: "Linter 无警告"
处理:
1. Read GLOBAL_STATE.md（获取 current_feature）
2. 执行 make lint --fix
3. 提交修复：git add . && git commit -m "fix: auto-fix linter warnings"
4. 更新 EVENT_LOG.md（追加 SESSION_END）
5. 调用 harness-check-clean-state（重新检查）
6. 检查通过（CLEAN）
输出:
✅ 清洁状态已恢复
修复内容: Linter 警告自动修复
提交哈希: abc1234
下一步：触发 harness-track-feature-progress（标记完成）
输入:
问题类型: 测试失败（2 个测试用例失败）
失败项: "测试通过"
处理:
1. Read GLOBAL_STATE.md
2. 分析测试失败日志
3. 定位失败原因（边界条件未处理）
4. 修改代码修复问题
5. 重新运行测试（成功）
6. 调用 harness-check-clean-state（重新检查）
7. 检查通过（CLEAN）
输出:
✅ 清洁状态已恢复
修复内容: 测试失败自动修复
失败次数: 1
修复项: 边界条件处理
下一步：触发 harness-track-feature-progress（标记完成）
输入:
问题类型: 编译失败（语法错误）
失败项: "代码编译"
处理:
1. Read GLOBAL_STATE.md
2. 查找上一个清洁提交（abc123）
3. 执行回滚：git reset --hard abc123
4. 验证回滚：make build（成功）
5. 调用 harness-check-clean-state（重新检查）
6. 检查通过（CLEAN）
输出:
✅ 清洁状态已恢复
回滚提交: abc123
回滚原因: 编译失败
下一步：重新开始当前功能开发
输入:
问题类型: 测试失败
失败次数: 3
处理:
1. 尝试修复（第 1 次）→ 失败
2. 尝试修复（第 2 次）→ 失败
3. 尝试修复（第 3 次）→ 失败
4. 失败次数 ≥ 3
5. 触发 harness-escalate-to-human
6. 记录到 EVENT_LOG.md（ESCALATION | FIX_FAILED_3_TIMES）
输出:
⚠️ 修复失败 3 次，自动恢复已穷尽
问题类型: 测试失败
当前功能: FEAT-001
失败次数: 3
下一步：进入真实阻塞升级流程
输入:
问题类型: 编译失败
回滚失败: git reset 失败
处理:
1. 尝试回滚 → 失败
2. 记录错误到 EVENT_LOG.md（ERROR | ROLLBACK_FAILED）
3. 触发 harness-escalate-to-human
输出:
🔴 回滚失败，自动恢复无法继续
问题类型: 编译失败
回滚命令: git reset --hard abc123
错误信息: fatal: Could not parse object 'abc123'
下一步：进入真实阻塞升级流程
三层兜底机制
修复优先级
失败计数
修复策略:
- MINOR_ISSUES: 快速修复（1 分钟内）
- MODERATE_ISSUES: 尝试修复（5-10 分钟）
- CRITICAL_ISSUES: 立即回滚（1 分钟内）
Token 优化:
- 避免重复读取文件
- 使用增量式状态摘要
- 并行执行多个检查项