agentleFS
konglong87konglong87/enjoy_harness_ai/skills/harness-escalate-to-human/SKILL.md

harness-escalate-to-human

Skill0 starsChanged 8 months agoMITView on GitHub

人工转交技能,当系统遇到无法自动处理的错误或达到熔断阈值时,生成详细报告并请求人工介入

The file

Files
SKILL.md

harness-escalate-to-human 人工转交技能

核心能力

  1. 检查前置条件(harness-handle-failure已完成)
  2. 收集完整的失败上下文
  3. 生成人工转交报告
  4. 分析失败根本原因
  5. 提供人工干预建议
  6. 仅在真实阻塞时触发人工决策
  7. 记录转交事件

前置条件

  • harness-init 已完成
  • harness-handle-failure 已完成
  • 存在需要人工介入的失败事件(熔断触发或无法自动处理)
  • .EnjoyHarness/EXECUTION_CONTRACT.md 标记 human_escalation_policy: true_blockers_only

执行步骤

Step 1: 检查前置条件

使用 Read 工具读取:.EnjoyHarness/SKILL_REGISTRY.md

检查条件:

  • harness-handle-failure 已标记为完成

如果未完成:

❌ 错误: 失败处理未执行
💡 请先运行: harness-handle-failure

Step 2: 识别触发原因

人工转交的触发场景:

强制边界:

  • 本技能不是常规流程步骤。
  • 只有自动回滚、自动重试、自动恢复全部失败,且确认属于真实阻塞时,才允许触发。
  • 任何“仅需要执行偏好选择”或“普通任务确认”的场景,都不应调用本技能。

2.1 任务级熔断

触发条件:

  • 同一任务错误计数 ≥ 3
  • 熔断文件存在:.EnjoyHarness/.circuit-breaker-task-{TASK_ID}

2.2 迭代次数熔断

触发条件:

  • 迭代计数达到上限(100次)
  • 熔断文件存在:.EnjoyHarness/.circuit-breaker-iteration

2.3 Token消耗熔断

触发条件:

  • 单任务Token消耗 > 10000

2.4 架构级错误

触发条件:

  • 严重架构违规
  • 无法自动修复的架构问题

2.5 多次重试失败

触发条件:

  • 经过多次自动重试后仍然失败
  • 策略A、策略B均无法解决

Step 3: 收集失败上下文

使用 Read 工具读取多个文件:

3.1 读取错误追踪

读取:.trace/ERROR_TRACE.md

提取:

  • 最近的失败记录
  • 错误类型和详情
  • 错误序列(如果多次失败)

3.2 读取全局状态

读取:.EnjoyHarness/GLOBAL_STATE.md

提取:

  • 当前任务ID
  • 当前迭代次数
  • 技能错误计数
  • 活跃子代理状态

3.3 读取迭代计数

读取:.EnjoyHarness/ITERATION_COUNTER.md

提取:

  • 当前迭代:N/100
  • 开始时间
  • 任务关联

3.4 读取事件日志

读取:.EnjoyHarness/EVENT_LOG.md

提取:

  • 最近10个事件
  • 失败相关事件
  • 熔断触发事件

3.5 读取失败报告

读取:.trace/FAILURE_REPORT_{TASK_ID}.md

提取:

  • 失败处理摘要
  • 已尝试的措施
  • 建议的下一步

Step 4: 分析失败根本原因

根据收集的上下文,AI分析失败的根本原因:

4.1 表面原因

  • 直接错误信息
  • 失败的技能和任务

4.2 深层原因

  • 为什么会失败
  • 是否有隐藏的依赖问题
  • 环境是否满足要求

4.3 影响范围

  • 哪些文件受影响
  • 哪些技能受影响
  • 是否影响其他任务

Step 5: 生成人工转交报告

使用 Bash 工具获取当前时间:

TIMESTAMP=$(date -Iseconds)
TASK_ID={当前任务ID}

echo "时间戳: $TIMESTAMP"
echo "任务ID: $TASK_ID"

使用 Write 工具创建报告:.trace/ESCALATION_REPORT_{TASK_ID}.md

内容:

---
escalation_id: ESC-{TIMESTAMP}
created_at: {TIMESTAMP}
task_id: {TASK_ID}
status: ESCALATED
priority: {CRITICAL/HIGH/MEDIUM}
---

# 人工转交报告

## 执行摘要

**转交时间**: {TIMESTAMP}
**任务ID**: {TASK_ID}
**优先级**: {CRITICAL/HIGH/MEDIUM}
**转交原因**: {熔断触发/多次失败/架构错误/其他}

---

## 触发原因详情

### 熔断信息
- 熔断类型: {任务级/迭代级/Token级}
- 触发条件: {具体条件}
- 熔断文件: {文件路径}

### 错误计数
- 技能: {技能名}
- 错误次数: {N}/3
- 错误类型: {代码/架构/流程}

### 迭代信息
- 当前迭代: {N}/100
- 开始时间: {开始时间}
- 已执行时长: {时长}

---

## 失败上下文

### 错误序列
{时间线方式展示失败序列}

示例:

T0: 任务开始 T+5min: 第一次失败(代码错误)→ 重试 T+10min: 第二次失败(不同原因)→ 重试 T+15min: 第三次失败(流程错误)→ 熔断触发


### 失败详情

#### 失败 #1
- 时间: {时间}
- 技能: {技能名}
- 错误: {错误信息}
- 处理: {处理措施}

#### 失败 #2
- 时间: {时间}
- 技能: {技能名}
- 错误: {错误信息}
- 处理: {处理措施}

#### 失败 #3
- 时间: {时间}
- 技能: {技能名}
- 错误: {错误信息}
- 处理: {处理措施}

---

## 已尝试的自动处理措施

- [x] 错误分类和分析
- [x] 失败上下文记录
- [x] Git回滚({是/否})
- [x] 自动重试(策略A,{N}次)
- [x] 调整后重试(策略B,{N}次)
- [x] 架构检查重新执行
- [x] 错误诊断技能触发

**结果**: 所有自动处理措施均未成功解决问题

---

## 根本原因分析

### 表面原因
{直接原因,如:编译错误、架构违规}

### 深层原因
{分析后的深层原因,如:
- 设计缺陷导致无法满足需求
- 环境配置不满足要求
- 依赖的服务不可用
- 需求理解有误
}

### 影响范围
- 受影响文件: {文件列表}
- 受影响技能: {技能列表}
- 阻塞任务: {任务列表}

---

## 当前系统状态

### 迭代计数
- 当前: {N}/100
- 状态: {正常/接近上限/已达上限}

### 技能错误计数
```yaml
harness-validate-output: {N}/3
harness-spawn-subharness-agent: {N}/3
{其他技能}: {N}/3

全局状态

  • 当前任务: {任务ID}
  • 状态: {熔断/暂停}
  • 活跃子代理: {数量}
  • 最近事件: {最近5个事件}

人工干预建议

建议1: 检查并修复代码

适用场景: 代码错误、语法错误

具体操作:

  1. 检查文件:{文件路径}
  2. 修复错误:{具体错误}
  3. 运行测试验证
  4. 手动清除熔断文件:.EnjoyHarness/.circuit-breaker-*
  5. 重新启动任务

建议2: 调整架构设计

适用场景: 架构错误、分层违规

具体操作:

  1. 检查架构违规:{具体违规}
  2. 调整代码结构以符合架构规则
  3. 更新ARCHITECTURE_GUARDRAILS.md(如果需要)
  4. 重新运行架构验证
  5. 清除熔断后重新执行

建议3: 检查环境配置

适用场景: 流程错误、依赖问题

具体操作:

  1. 检查依赖服务状态
  2. 验证环境变量配置
  3. 确认权限设置
  4. 调整执行顺序(如果需要)
  5. 重新启动任务

建议4: 调整需求或方案

适用场景: 需求理解偏差、方案不可行

具体操作:

  1. 重新审视原始需求
  2. 评估当前方案的可行性
  3. 调整方案或寻求澄清
  4. 更新目标文件(memory/goals/)
  5. 从头开始执行

建议5: 人工完成该任务

适用场景: 所有自动处理失败、复杂问题

具体操作:

  1. 人工检查代码和日志
  2. 手动修复问题
  3. 提交代码
  4. 更新目标文件状态为completed
  5. 清理熔断文件

标准处置选项

人工接管后可参考以下标准处置路径:

选项A: 修复后继续

  • 人工修复问题
  • 清除熔断文件
  • 系统自动继续执行

选项B: 调整方案后重新开始

  • 调整需求或方案
  • 更新目标文件
  • 从头开始执行

选项C: 人工完成并结束

  • 人工完成剩余工作
  • 更新目标状态为completed
  • 记录经验教训

选项D: 放弃任务

  • 记录放弃原因
  • 清理临时文件
  • 标记任务为abandoned

后续步骤(待人工决策后执行)

如果选择选项A(修复后继续)

# 1. 人工修复完成后
# 2. 清除熔断文件
rm .EnjoyHarness/.circuit-breaker-*

# 3. 重置错误计数(手动编辑GLOBAL_STATE.md)
# 4. 系统自动检测熔断清除,继续执行

如果选择选项B(调整后重新开始)

# 1. 更新目标文件(手动编辑 memory/goals/)
# 2. 清理工作目录(可选)
# 3. 清除熔断和错误记录
# 4. 重新调用harness-init或相关技能

如果选择选项C(人工完成)

# 1. 人工完成工作并提交代码
# 2. 手动编辑目标文件:status: completed
# 3. 清理熔断和错误记录
# 4. 记录经验到.learnings/

如果选择选项D(放弃)

# 1. 手动编辑目标文件:status: abandoned
# 2. 清理临时文件和工作目录
# 3. 记录放弃原因到ERROR_HANDBOOK.md

联系信息(如果适用)

如需进一步协助,请提供:

  • 任务ID: {TASK_ID}
  • 转交报告路径: .trace/ESCALATION_REPORT_{TASK_ID}.md
  • 错误追踪路径: .trace/ERROR_TRACE.md
  • 全局状态路径: .EnjoyHarness/GLOBAL_STATE.md

附录:相关文件清单

日志文件

  • 错误追踪: .trace/ERROR_TRACE.md
  • 事件日志: .EnjoyHarness/EVENT_LOG.md
  • 失败报告: .trace/FAILURE_REPORT_{TASK_ID}.md

状态文件

  • 全局状态: .EnjoyHarness/GLOBAL_STATE.md
  • 迭代计数: .EnjoyHarness/ITERATION_COUNTER.md
  • 技能注册: .EnjoyHarness/SKILL_REGISTRY.md

目标文件

  • 目标文件: memory/goals/{TIMESTAMP}_{关键词}.md

熔断文件

  • 熔断文件: .EnjoyHarness/.circuit-breaker-*

报告生成时间: {TIMESTAMP} 报告生成技能: harness-escalate-to-human v3.0.0


### Step 6: 输出人工提示

使用 Bash 工具输出醒目的人工介入提示:

```bash
echo ""
echo "🚨🚨🚨 需要人工介入 🚨🚨🚨"
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "人工转交报告已生成"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "📋 报告路径: .trace/ESCALATION_REPORT_{TASK_ID}.md"
echo "🆔 转交ID: ESC-{TIMESTAMP}"
echo "⚡ 优先级: {CRITICAL/HIGH/MEDIUM}"
echo ""
echo "触发原因:"
echo "  {触发原因详情}"
echo ""
echo "已尝试的自动处理:"
echo "  - 错误分类和分析 ✓"
echo "  - Git回滚 {是/否} ✓"
echo "  - 自动重试 {N}次 ✓"
echo "  - 所有措施均未成功"
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo "请查看完整报告并选择处理方案:"
echo "  A. 修复后继续"
echo "  B. 调整方案后重新开始"
echo "  C. 人工完成并结束"
echo "  D. 放弃任务"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""
echo "⚠️  注意: 系统已暂停,等待人工决策"
echo "⚠️  熔断文件: .EnjoyHarness/.circuit-breaker-*"
echo ""

Step 7: 记录转交事件

使用 Edit 工具追加到:.EnjoyHarness/EVENT_LOG.md

{TIMESTAMP} | ESCALATION | harness-escalate-to-human | 转交人工介入 (任务: {TASK_ID}, 原因: {原因}) | ESCALATED
{TIMESTAMP} | SYSTEM_PAUSE | harness-escalate-to-human | 系统暂停,等待人工决策 | PAUSED

Step 8: 更新全局状态

使用 Edit 工具更新:.EnjoyHarness/GLOBAL_STATE.md

## 当前任务
- 任务ID: {TASK_ID}
- 状态: ESCALATED(人工转交)
- 开始时间: {开始时间}
- 转交时间: {当前时间}
- 转交原因: {原因}

## 系统状态
- 状态: PAUSED(等待人工决策)
- 转交报告: .trace/ESCALATION_REPORT_{TASK_ID}.md

Step 9: 更新迭代计数

使用 Edit 工具更新:.EnjoyHarness/ITERATION_COUNTER.md

增加计数(本技能约8次迭代):

current_iteration: N+8

Step 10: 标记技能完成

使用 Edit 工具更新:.EnjoyHarness/SKILL_REGISTRY.md

- [x] harness-escalate-to-human - 人工转交技能 ✅

Step 11: 等待人工决策

系统状态已设置为PAUSED,等待人工:

  1. 阅读转交报告
  2. 选择处理方案(A/B/C/D)
  3. 执行相应操作
  4. 清除熔断文件或更新状态
  5. 通知系统继续或结束

Step 12: 输出完成信息

使用 Bash 工具输出:

echo ""
echo "✅ harness-escalate-to-human 执行完成"
echo ""
echo "📋 转交报告已生成:"
echo "   .trace/ESCALATION_REPORT_{TASK_ID}.md"
echo ""
echo "📌 系统状态: PAUSED(等待人工决策)"
echo ""
echo "💡 提示:"
echo "   - 请查看转交报告了解详细情况"
echo "   - 选择处理方案后,清除熔断文件或更新状态"
echo "   - 需要帮助请提供任务ID: {TASK_ID}"
echo ""

成功标准

  • 触发原因已识别
  • 失败上下文已完整收集
  • 人工转交报告已生成
  • 根本原因已分析
  • 人工干预建议已提供
  • 决策选项已明确
  • 事件已记录到EVENT_LOG.md
  • 全局状态已更新为ESCALATED
  • 系统已暂停等待人工决策
  • 迭代计数已更新
  • 技能已标记为完成

失败兜底

  • 前置条件未满足 → 终止执行,提示运行前置技能
  • 无法生成报告 → 记录错误,输出紧急提示
  • 报告文件创建失败 → 尝试多次,仍失败则输出到控制台

联动关系

  • 前置技能: harness-handle-failure
  • 触发场景: 任务级熔断、迭代熔断、架构错误、多次失败
  • 触发前提: 必须已经穷尽自动恢复手段,且属于真实阻塞
  • 人工决策后:
    • 选项A: 清除熔断后自动继续
    • 选项B: 更新目标后重新开始
    • 选项C: 标记完成
    • 选项D: 标记放弃

迭代计数

本技能执行预计迭代次数: 约8次(Write 1次 + Edit 4次 + Read 3次 + Bash 2次)

测试用例

测试场景1:任务级熔断转交

输入:

触发: 同一任务失败3次
熔断文件: .EnjoyHarness/.circuit-breaker-task-001
错误计数: 3/3

预期输出:

  • 读取所有相关文件(ERROR_TRACE, GLOBAL_STATE, EVENT_LOG)
  • 生成ESCALATION_REPORT_task-001.md
  • 报告包含完整失败序列
  • 提供5个人工干预建议
  • 输出醒目的人工提示
  • 系统状态设为PAUSED

测试场景2:迭代熔断转交

输入:

触发: 迭代计数达到上限
当前迭代: 100/100
熔断文件: .EnjoyHarness/.circuit-breaker-iteration

预期输出:

  • 分析迭代次数超限原因
  • 生成包含迭代详情的转交报告
  • 建议:简化方案或分阶段执行
  • 提供决策选项

测试场景3:架构错误转交

输入:

触发: 严重架构违规
错误类型: ARCHITECTURE_ERROR
已尝试: 架构修复(失败)

预期输出:

  • 分析架构违规详情
  • 建议架构调整方案
  • 提供详细的架构修复步骤
  • 建议选项B(调整后重新开始)

测试场景4:Token消耗超限转交

输入:

触发: Token消耗 > 10000
单任务Token: 12500

预期输出:

  • 分析Token消耗分布
  • 建议优化方案或分阶段执行
  • 提供Token使用详情
  • 建议选项B(简化方案)

测试场景5:多次重试失败转交

输入:

失败序列:
- 第一次: 代码错误 → 重试(策略A)
- 第二次: 不同错误 → 重试(策略A)
- 第三次: 流程错误 → 重试(策略B)
- 第四次: 失败 → 熔断

预期输出:

  • 完整失败序列时间线
  • 每次失败的处理措施
  • 根本原因分析
  • 建议选项A或C(修复或人工完成)

测试场景6:人工决策后继续(选项A)

输入:

人工修复完成
选择: 选项A(修复后继续)
操作: 清除熔断文件

预期输出:

  • 检测到熔断文件已清除
  • 系统状态从PAUSED恢复为ACTIVE
  • 重置错误计数
  • 继续执行后续技能

测试场景7:人工决策后放弃(选项D)

输入:

人工决定放弃任务
选择: 选项D(放弃任务)

预期输出:

  • 目标文件状态更新为abandoned
  • 清理临时文件
  • 记录放弃原因到ERROR_HANDBOOK.md
  • 系统状态恢复正常(无当前任务)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.