harness-diagnose-and-improve
Skill0 starsChanged 8 months agoMITView on GitHub
错误诊断与改进技能,分析错误根因、生成修复建议、反哺规则到ERROR_HANDBOOK.md
In this repository33 other files it gives its agents.
- harness-10x-productivity-boostSkill
- harness-adjust-granularitySkill
- harness-analyze-project-scaleSkill
- harness-auto-full-executionSkill
- harness-brainstormSkill
- harness-build-context-indexSkill
- harness-build-core-manifestSkill
- harness-build-deterministic-workflowSkill
- harness-check-clean-stateSkill
- harness-configSkill
- harness-context-clearSkill
- harness-determine-granularitySkill
- harness-enable-circuit-breakerSkill
- harness-enforce-architecture-guardrailsSkill
- harness-escalate-to-humanSkill
- harness-evaluate-performanceSkill
- harness-evolveSkill
- harness-executing-plansSkill
- harness-generate-feature-listSkill
- harness-goalSkill
- harness-handle-failureSkill
- harness-initSkill
- harness-merge-agent-resultsSkill
- harness-merge-subharness-resultSkill
- harness-monitor-agent-batchSkill
- harness-monitor-subharness-agentSkill
- harness-planSkill
- harness-recover-clean-stateSkill
- harness-schedule-parallel-agentsSkill
- harness-session-handoffSkill
- harness-spawn-subharness-agentSkill
- harness-track-feature-progressSkill
- harness-validate-outputSkill
The file
Files
harness-diagnose-and-improve 错误诊断与改进技能
核心能力
- 检查前置条件(harness-enable-circuit-breaker)
- 读取错误追踪文件(ERROR_TRACE.md)
- 分析错误根因(5 Why分析法)
- 生成修复建议
- 反哺规则到ERROR_HANDBOOK.md
- 更新.learnings/ERRORS.md
- 记录诊断事件
- 更新全局状态
前置条件
- harness-init 已完成
- harness-enable-circuit-breaker 已完成
- ERROR_TRACE.md 文件存在(或可创建)
执行步骤
Step 1: 检查前置条件
使用 Read 工具读取:.EnjoyHarness/SKILL_REGISTRY.md
检查条件:
- harness-enable-circuit-breaker 已标记为完成
如果未完成:
❌ 错误: 熔断机制未执行
💡 请先运行: harness-enable-circuit-breakerStep 2: 读取错误追踪文件
使用 Read 工具读取:.trace/ERROR_TRACE.md
如果文件不存在,使用 Write 工具创建:
---
created_at: {当前时间}
total_errors: 0
---
# EnjoyHarness 错误追踪
## 错误记录格式
时间 | 任务ID | 技能 | 错误类型 | 错误详情 | 根因分析 | 修复方案
## 错误列表
(暂无错误记录)Step 3: 提取最近的错误
使用 Bash 工具查询:
# 获取最近的错误记录(最近5条)
RECENT_ERRORS=$(tail -5 .trace/ERROR_TRACE.md | grep "^20")
echo "最近的错误:"
echo "$RECENT_ERRORS"或者从GLOBAL_STATE.md中获取:
# 读取当前任务的错误信息
CURRENT_TASK=$(grep -A 20 "current_task" .EnjoyHarness/GLOBAL_STATE.md | grep "task_id" | awk '{print $2}')
ERROR_COUNT=$(grep -A 20 "current_task" .EnjoyHarness/GLOBAL_STATE.md | grep "error_count" | awk '{print $2}')
if [ "$ERROR_COUNT" -gt 0 ]; then
echo "当前任务: $CURRENT_TASK"
echo "错误计数: $ERROR_COUNT"
fiStep 4: 分析错误根因(5 Why分析法)
对每个错误执行:
### 错误分析示例
**错误描述**: API调用超时
**5 Why分析**:
1. 为什么API调用超时? → 网络请求耗时超过30秒
2. 为什么耗时超过30秒? → 服务器响应慢
3. 为什么服务器响应慢? → 数据库查询未优化
4. 为什么查询未优化? → 缺少索引
5. 为什么缺少索引? → 开发时未考虑性能
**根因**: 开发流程缺少性能审查环节
**修复方案**:
- 短期: 添加数据库索引
- 中期: 优化查询语句
- 长期: 增加性能审查流程使用 Bash 工具生成分析:
ERROR_DESC="{错误描述}"
echo "=== 错误分析 ==="
echo "错误: $ERROR_DESC"
echo ""
echo "5 Why分析:"
echo "1. 为什么出现这个错误?"
read WHY1
echo "2. 为什么$WHY1?"
read WHY2
echo "3. 为什么$WHY2?"
read WHY3
echo "4. 为什么$WHY3?"
read WHY4
echo "5. 为什么$WHY4?"
read WHY5
echo ""
echo "根因: $WHY5"
echo ""
echo "修复方案:"
echo "短期: {快速修复}"
echo "中期: {流程改进}"
echo "长期: {架构优化}"Step 5: 生成修复建议
根据错误类型生成建议:
类型1: 代码错误
**错误类型**: 代码错误
**错误详情**: {具体错误}
**根因分析**: {5 Why分析结果}
**修复建议**:
1. 立即修复: {具体代码修改}
2. 代码审查: {审查重点}
3. 测试验证: {测试用例}类型2: 架构错误
**错误类型**: 架构错误
**错误详情**: {架构违规}
**根因分析**: {5 Why分析结果}
**修复建议**:
1. 重构方案: {架构调整}
2. 迁移路径: {重构步骤}
3. 防止复发: {架构护栏规则}类型3: 流程错误
**错误类型**: 流程错误
**错误详情**: {流程问题}
**根因分析**: {5 Why分析结果}
**修复建议**:
1. 流程优化: {改进方案}
2. 规则更新: {新增规则}
3. 自动化: {自动化检查}Step 6: 反哺规则到ERROR_HANDBOOK.md
使用 Read 工具读取:.EnjoyHarness/ERROR_HANDBOOK.md
如果文件不存在,使用 Write 工具创建基础结构:
---
created_at: {当前时间}
version: v1.0.0
total_rules: 0
---
# EnjoyHarness 错误手册
## 错误分类
### 1. 代码错误
{代码错误规则列表}
### 2. 架构错误
{架构错误规则列表}
### 3. 流程错误
{流程错误规则列表}
## 错误处理规则
### 规则格式
```yaml
错误ID: {ERROR-XXX}
错误类型: {类型}
错误描述: {描述}
根因: {根本原因}
修复方案: {解决方案}
预防措施: {如何防止}
示例: {实际案例}规则列表
(待添加)
使用 Edit 工具追加新规则:
```markdown
### {ERROR-001}: {错误名称}
**错误类型**: {类型}
**错误描述**: {详细描述}
**根因**: {根本原因}
**触发条件**: {何时发生}
**修复方案**:
- 立即修复: {快速方案}
- 根本修复: {彻底方案}
**预防措施**:
- 开发阶段: {如何预防}
- 测试阶段: {如何检测}
- 上线阶段: {如何监控}
**示例**:{代码示例或场景描述}
**反哺日期**: {当前时间}
**来源任务**: {任务ID}Step 7: 更新.learnings/ERRORS.md
使用 Read 工具读取:.learnings/ERRORS.md
如果文件不存在,使用 Write 工具创建:
---
created_at: {当前时间}
total_learnings: 0
---
# EnjoyHarness 错误学习记录
## 学习记录格式
日期 | 错误类型 | 关键教训 | 改进措施
## 学习列表
(暂无学习记录)使用 Edit 工具追加学习记录:
{当前时间} | {错误类型} | {关键教训} | {改进措施}Step 8: 生成诊断报告
使用 Write 工具创建文件:.EnjoyHarness/DIAGNOSIS_REPORT.md
---
generated_at: {当前时间}
task_id: {任务ID}
error_count: {错误数量}
analyzed_count: {已分析数量}
---
# 错误诊断报告
## 诊断概况
- 诊断时间: {当前时间}
- 任务ID: {任务ID}
- 错误总数: {错误数量}
- 已分析数: {已分析数量}
## 错误分析
### 错误 1: {错误名称}
**错误描述**: {详细描述}
**错误类型**: {类型}
**发生时间**: {时间}
**发生技能**: {技能名称}
**5 Why分析**:
1. {Why 1}
2. {Why 2}
3. {Why 3}
4. {Why 4}
5. {Why 5}
**根因**: {根本原因}
**修复建议**:
- ✅ 立即修复: {方案}
- ✅ 中期改进: {方案}
- ✅ 长期优化: {方案}
**预防措施**: {如何防止复发}
---
## 错误统计
### 按类型统计
- 代码错误: {数量}次
- 架构错误: {数量}次
- 流程错误: {数量}次
### 按技能统计
- harness-validate-output: {数量}次
- harness-spawn-subharness-agent: {数量}次
- {其他技能}: {数量}次
## 反馈改进
### 已反哺规则
- {ERROR-XXX}: {规则名称}
- {ERROR-XXX}: {规则名称}
### 已更新文档
- ERROR_HANDBOOK.md: 新增{数量}条规则
- .learnings/ERRORS.md: 新增{数量}条学习记录
## 下一步行动
### 立即行动
- [ ] 修复错误(优先级: P0)
- [ ] 更新相关代码
- [ ] 执行测试验证
### 中期行动
- [ ] 更新开发流程
- [ ] 增加自动化检查
- [ ] 培训团队成员
### 长期行动
- [ ] 架构优化
- [ ] 重构遗留代码
- [ ] 持续监控指标Step 9: 记录诊断事件
使用 Edit 工具追加内容到:.EnjoyHarness/EVENT_LOG.md
{当前时间} | ERROR_DIAGNOSIS | harness-diagnose-and-improve | 诊断错误: {数量}个 | SUCCESS
{当前时间} | RULE_FEEDBACK | harness-diagnose-and-improve | 反哺规则: {规则ID} | SUCCESSStep 10: 更新全局状态
使用 Edit 工具更新:.EnjoyHarness/GLOBAL_STATE.md
last_diagnosis: {当前时间}
diagnosis_status: COMPLETED
errors_analyzed: {数量}
rules_added: {数量}Step 11: 更新事件计数
使用 Edit 工具更新:.EnjoyHarness/EVENT_LOG.md
old_string: total_events: N
new_string: total_events: N+2
Step 12: 更新技能注册表
使用 Edit 工具更新:.EnjoyHarness/SKILL_REGISTRY.md
old_string: - [ ] harness-diagnose-and-improve - 错误诊断技能
new_string: - [x] harness-diagnose-and-improve - 错误诊断技能 ✅
Step 13: 输出完成信息
使用 Bash 工具输出:
echo ""
echo "✅ harness-diagnose-and-improve 完成!"
echo ""
echo "🔍 诊断结果:"
echo " - 分析错误数: {数量}"
echo " - 反哺规则数: {数量}"
echo " - 更新文档数: {数量}"
echo ""
echo "📋 报告:"
echo " - 诊断报告: .EnjoyHarness/DIAGNOSIS_REPORT.md"
echo " - 错误手册: .EnjoyHarness/ERROR_HANDBOOK.md"
echo " - 学习记录: .learnings/ERRORS.md"
echo ""
echo "🎯 下一步:"
echo " - 执行修复建议"
echo " - 或触发 harness-evolve(自我进化)"
echo ""成功标准
- 读取错误追踪文件
- 分析错误根因(5 Why)
- 生成修复建议
- 反哺规则到ERROR_HANDBOOK.md
- 更新.learnings/ERRORS.md
- 生成诊断报告
- 记录诊断事件
- 更新全局状态
- 更新事件日志
- 技能注册表已更新
失败兜底
- harness-enable-circuit-breaker 未完成 → 终止执行,提示运行前置技能
- 无错误记录 → 输出"暂无错误需要诊断"
联动关系
- 前置: harness-enable-circuit-breaker
- 自动触发: harness-evolve(自我进化)
迭代计数
本技能执行预计迭代次数: 约 12 次(Read 3次 + Write 2次 + Edit 5次 + Bash 2次)
测试用例
测试 1: 前置条件检查
输入: 在熔断机制未执行时运行 期望输出: 错误提示"熔断机制未执行" 验证方式: 删除熔断相关文件后运行
测试 2: 错误根因分析
输入: 提供一个具体的错误 期望输出: 完整的5 Why分析 验证方式: 手动提供错误,检查分析结果
测试 3: 反哺规则
输入: 分析错误后
期望输出: ERROR_HANDBOOK.md新增规则
验证方式: grep "{ERROR-XXX}" .EnjoyHarness/ERROR_HANDBOOK.md
测试 4: 学习记录更新
输入: 执行诊断后
期望输出: .learnings/ERRORS.md新增记录
验证方式: tail -1 .learnings/ERRORS.md
测试 5: 诊断报告生成
输入: 执行诊断
期望输出: 生成 DIAGNOSIS_REPORT.md
验证方式: ls .EnjoyHarness/DIAGNOSIS_REPORT.md
测试 6: 全局状态更新
输入: 读取 GLOBAL_STATE.md
期望输出: diagnosis_status 为 COMPLETED
验证方式: grep "diagnosis_status" .EnjoyHarness/GLOBAL_STATE.md
测试 7: 事件日志记录
输入: 读取 EVENT_LOG.md
期望输出: 包含 ERROR_DIAGNOSIS 事件
验证方式: grep "ERROR_DIAGNOSIS" .EnjoyHarness/EVENT_LOG.md
测试 8: 无错误情况
输入: 无错误记录时运行 期望输出: 输出"暂无错误需要诊断" 验证方式: 清空ERROR_TRACE.md后运行
5 Why分析法详解
方法论
目的: 找到错误的根本原因,而不是表面现象
步骤:
1. 描述问题
2. 问"为什么"第1次
3. 问"为什么"第2次
4. 问"为什么"第3次
5. 问"为什么"第4次
6. 问"为什么"第5次
7. 找到根因
8. 制定修复方案
原则:
- 不满足于表面答案
- 每次问"为什么"都要深入一层
- 根因通常是流程或系统问题,而非人为错误示例分析
示例 1: API调用失败
问题: API调用返回500错误
Why 1: 服务器内部错误
Why 2: 数据库连接超时
Why 3: 数据库查询耗时过长
Why 4: 缺少必要索引
Why 5: 开发时未进行性能测试
根因: 开发流程缺少性能测试环节
修复方案:
- 立即修复: 添加数据库索引
- 中期改进: 优化查询语句
- 长期优化: 增加性能测试流程示例 2: 代码编译失败
问题: 编译报错"undefined variable"
Why 1: 变量未定义
Why 2: 变量名拼写错误
Why 3: 手动输入,未使用IDE自动补全
Why 4: 开发者不熟悉IDE功能
Why 5: 缺少IDE使用培训
根因: 开发培训不充分
修复方案:
- 立即修复: 修正变量名
- 中期改进: 使用IDE代码检查
- 长期优化: 增加开发培训错误分类体系
1. 代码错误
类型:
- 语法错误: 编译失败
- 逻辑错误: 功能异常
- 性能错误: 响应慢、资源占用高
- 安全错误: 注入、XSS等
处理方式:
- 立即修复代码
- 增加单元测试
- 代码审查2. 架构错误
类型:
- 分层违规: 跨层调用
- 循环依赖: 模块间循环引用
- 设计缺陷: 架构设计不合理
- 扩展性差: 难以扩展新功能
处理方式:
- 重构架构
- 增加架构护栏
- 更新架构文档3. 流程错误
类型:
- 需求误解: 需求理解偏差
- 沟通不畅: 信息传递错误
- 流程缺失: 缺少必要步骤
- 自动化不足: 手动操作过多
处理方式:
- 优化流程
- 增加检查点
- 自动化改进反哺规则机制
反哺流程
[错误发生] → [错误记录] → [错误诊断]
↓
[根因分析] → [规则提取] → [规则验证]
↓
[反哺到ERROR_HANDBOOK.md]
↓
[后续开发使用规则预防]规则模板
错误ID: ERROR-{序号}
错误类型: {类型}
错误描述: {详细描述}
触发条件: {何时发生}
根因分析: {根本原因}
修复方案:
立即修复: {方案}
中期改进: {方案}
长期优化: {方案}
预防措施:
开发阶段: {措施}
测试阶段: {措施}
上线阶段: {措施}
示例: {实际案例}
反哺日期: {日期}
来源任务: {任务ID}使用示例
示例 1: 诊断单个错误
错误: API调用超时
分析: 5 Why → 根因: 缺少性能测试
反哺: ERROR-001 → "性能测试规则"
修复: 添加索引 + 性能测试流程
结果: 错误修复,规则反哺示例 2: 批量诊断多个错误
错误列表: 3个错误
- 错误1: 代码错误 → 根因: 缺少代码审查
- 错误2: 架构错误 → 根因: 架构规则不明确
- 错误3: 流程错误 → 根因: 需求文档不清晰
反哺规则: 3条
- ERROR-001: 代码审查规则
- ERROR-002: 架构设计规则
- ERROR-003: 需求文档规则
结果: 批量反哺,系统改进与其他技能的协作
协作流程
harness-enable-circuit-breaker(检测错误)
↓
harness-diagnose-and-improve(诊断根因)
↓
harness-evolve(自我进化)协作示例
场景: 任务执行失败
阶段1: 错误检测
- harness-enable-circuit-breaker → 检测到错误
阶段2: 错误诊断
- harness-diagnose-and-improve → 分析根因
├─ 5 Why分析
├─ 生成修复建议
└─ 反哺规则
阶段3: 自我进化
- harness-evolve → 应用规则
├─ 更新ERROR_HANDBOOK.md
├─ 清理技术债
└─ 持续改进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
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.

