with one click
harness-escalate-to-human
人工转交技能,当系统遇到无法自动处理的错误或达到熔断阈值时,生成详细报告并请求人工介入
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Menu
人工转交技能,当系统遇到无法自动处理的错误或达到熔断阈值时,生成详细报告并请求人工介入
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
EnjoyHarness 唯一强制入口,初始化全局状态、文件体系、技能注册表
配置文件读取和验证技能,确保用户配置正确且完整
全流程自动执行超级组合技能,编排所有16个基础技能,从用户需求到完整交付的全自动化流程
头脑风暴技能,在实现前探索用户意图、需求和设计,防止返工
实施计划执行技能,逐任务执行实施计划,支持检查点、错误恢复和进度跟踪
10倍产能提效超级组合技能,通过并行执行、智能调度、优化策略实现10倍开发效率提升
| name | harness-escalate-to-human |
| description | 人工转交技能,当系统遇到无法自动处理的错误或达到熔断阈值时,生成详细报告并请求人工介入 |
| trigger_words | ["harness-escalate-to-human","人工转交","escalate","人工介入","human intervention"] |
| priority | HIGH |
| dependencies | ["harness-handle-failure"] |
| version | v3.0.0 |
.EnjoyHarness/EXECUTION_CONTRACT.md 标记 human_escalation_policy: true_blockers_only使用 Read 工具读取:.EnjoyHarness/SKILL_REGISTRY.md
检查条件:
如果未完成:
❌ 错误: 失败处理未执行
💡 请先运行: harness-handle-failure
人工转交的触发场景:
强制边界:
触发条件:
.EnjoyHarness/.circuit-breaker-task-{TASK_ID}触发条件:
.EnjoyHarness/.circuit-breaker-iteration触发条件:
触发条件:
触发条件:
使用 Read 工具读取多个文件:
读取:.trace/ERROR_TRACE.md
提取:
读取:.EnjoyHarness/GLOBAL_STATE.md
提取:
读取:.EnjoyHarness/ITERATION_COUNTER.md
提取:
读取:.EnjoyHarness/EVENT_LOG.md
提取:
读取:.trace/FAILURE_REPORT_{TASK_ID}.md
提取:
根据收集的上下文,AI分析失败的根本原因:
使用 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
适用场景: 代码错误、语法错误
具体操作:
.EnjoyHarness/.circuit-breaker-*适用场景: 架构错误、分层违规
具体操作:
适用场景: 流程错误、依赖问题
具体操作:
适用场景: 需求理解偏差、方案不可行
具体操作:
适用场景: 所有自动处理失败、复杂问题
具体操作:
人工接管后可参考以下标准处置路径:
# 1. 人工修复完成后
# 2. 清除熔断文件
rm .EnjoyHarness/.circuit-breaker-*
# 3. 重置错误计数(手动编辑GLOBAL_STATE.md)
# 4. 系统自动检测熔断清除,继续执行
# 1. 更新目标文件(手动编辑 memory/goals/)
# 2. 清理工作目录(可选)
# 3. 清除熔断和错误记录
# 4. 重新调用harness-init或相关技能
# 1. 人工完成工作并提交代码
# 2. 手动编辑目标文件:status: completed
# 3. 清理熔断和错误记录
# 4. 记录经验到.learnings/
# 1. 手动编辑目标文件:status: abandoned
# 2. 清理临时文件和工作目录
# 3. 记录放弃原因到ERROR_HANDBOOK.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.mdmemory/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 ""
使用 Edit 工具追加到:.EnjoyHarness/EVENT_LOG.md
{TIMESTAMP} | ESCALATION | harness-escalate-to-human | 转交人工介入 (任务: {TASK_ID}, 原因: {原因}) | ESCALATED
{TIMESTAMP} | SYSTEM_PAUSE | harness-escalate-to-human | 系统暂停,等待人工决策 | PAUSED
使用 Edit 工具更新:.EnjoyHarness/GLOBAL_STATE.md
## 当前任务
- 任务ID: {TASK_ID}
- 状态: ESCALATED(人工转交)
- 开始时间: {开始时间}
- 转交时间: {当前时间}
- 转交原因: {原因}
## 系统状态
- 状态: PAUSED(等待人工决策)
- 转交报告: .trace/ESCALATION_REPORT_{TASK_ID}.md
使用 Edit 工具更新:.EnjoyHarness/ITERATION_COUNTER.md
增加计数(本技能约8次迭代):
current_iteration: N+8
使用 Edit 工具更新:.EnjoyHarness/SKILL_REGISTRY.md
- [x] harness-escalate-to-human - 人工转交技能 ✅
系统状态已设置为PAUSED,等待人工:
使用 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 ""
本技能执行预计迭代次数: 约8次(Write 1次 + Edit 4次 + Read 3次 + Bash 2次)
输入:
触发: 同一任务失败3次
熔断文件: .EnjoyHarness/.circuit-breaker-task-001
错误计数: 3/3
预期输出:
输入:
触发: 迭代计数达到上限
当前迭代: 100/100
熔断文件: .EnjoyHarness/.circuit-breaker-iteration
预期输出:
输入:
触发: 严重架构违规
错误类型: ARCHITECTURE_ERROR
已尝试: 架构修复(失败)
预期输出:
输入:
触发: Token消耗 > 10000
单任务Token: 12500
预期输出:
输入:
失败序列:
- 第一次: 代码错误 → 重试(策略A)
- 第二次: 不同错误 → 重试(策略A)
- 第三次: 流程错误 → 重试(策略B)
- 第四次: 失败 → 熔断
预期输出:
输入:
人工修复完成
选择: 选项A(修复后继续)
操作: 清除熔断文件
预期输出:
输入:
人工决定放弃任务
选择: 选项D(放弃任务)
预期输出: