Skip to content
Skills Library
AI & agents · Analysis

agent-introspection-debugging

/agent-introspection-debugging

使用捕获、诊断、受控恢复和内省报告的结构化自我调试工作流程,用于 AI 智能体失败。

Licence
MIT
Last repository change
21.06.2026

Assessment and security

96/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability21 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

使用捕获、诊断、受控恢复和内省报告的结构化自我调试工作流程,用于 AI 智能体失败。

Original author description

使用捕获、诊断、受控恢复和内省报告的结构化自我调试工作流程,用于 AI 智能体失败。

How it works

  1. 何时激活
  2. 范围边界
  3. 四阶段循环
  4. 恢复启发式
  5. 与 ECC 集成
  6. 输出标准
Original SKILL.md headings · 149 lines, 284 words
SKILL.md preview
---
name: agent-introspection-debugging
description: 使用捕获、诊断、受控恢复和内省报告的结构化自我调试工作流程,用于 AI 智能体失败。
origin: ECC
---

# 智能体内省调试

当智能体运行反复失败、消耗令牌而无进展、在同一工具上循环或偏离预期任务时,使用此技能。

这是一个工作流技能,而非隐藏运行时。它教导智能体在升级到人工之前系统地调试自己。

## 何时激活

- 最大工具调用 / 循环限制失败
- 重复重试且没有进展
- 上下文增长或提示漂移开始降低输出质量
- 文件系统或环境状态与预期和现实之间不匹配
- 可能通过诊断和较小的纠正操作恢复的工具失败

## 范围边界

激活此技能用于:
- 在盲目重试之前捕获失败状态
- 诊断常见的智能体特定失败模式
- 应用受控的恢复操作
- 生成结构化的可人工阅读的调试报告

不要将此技能作为主要来源用于:
- 代码更改后的功能验证;使用 `verification-loop`
- 更窄的 ECC 技能已存在的框架特定调试
- 当前工具无法自动强制执行的运行时承诺

## 四阶段循环

### 阶段 1:失败捕获

在尝试恢复之前,精确记录失败。

捕获:
- 错误类型、消息和堆栈跟踪(如果可用)
- 最后有意义的工具调用序列
- 智能体试图做什么
- 当前上下文压力:重复提示、过大粘贴日志、重复计划或失控注释
- 当前环境假设:cwd、分支、相关服务状态、预期文件

最小捕获模板:

```markdown
## 失败捕获
- 会话 / 任务:
- 进行中的目标:
- 错误:
- 最后成功步骤:
- 最后失败的工具 / 命令:
- 看到的重复模式:
- 要验证的环境假设:
```

### 阶段 2:根本原因诊断

在更改任何内容之前,将失败与已知模式匹配。

| 模式 | 可能原因 | 检查 |
| --- | --- | --- |
| 最大工具调用 / 重复相同命令 | 循环或无退出观察者路径 | 检查最后 N 次工具调用的重复 |
| 上下文溢出 / 退化推理 | 无限制注释、重复计划、过大日志 | 检查最近上下文的重复和低信号批量 |
| `ECONNREFUSED` / 超时 | 服务不可用或端口错误 | 验证服务健康、URL 和端口假设 |
| `429` / 配额耗尽 | 重试风暴或缺少退避 | 计算重复调用并检查重试间隔 |
| 写入后文件缺失 / 过时差异 | 竞争、错误 cwd 或分支漂移 | 重新检查路径、cwd、git 状态和实际文件存在 |
| "修复"后测试仍然失败 | 错误假设 | 隔离确切的失败测试并重新推导错误 |

诊断问题:
- 这是逻辑失败、状态失败、环境失败还是策略失败?
- 智能体是否失去了真实目标并开始优化错误的子任务?
- 失败是确定性的还是瞬态的?
- 什么是最小的可逆操作来验证诊断?

### 阶段 3:受控恢复

使用改变诊断表面的最小操作进行恢复。

安全的恢复操作:
- 停止重复重试并重新陈述假设
- 修剪低信号上下文,仅保留活动目标、阻止器和证据
- 重新检查实际文件系统 / 分支 / 进程状态
- 将任务缩小到一个失败命令、一个文件或一个测试
- 从推测推理切换到直接观察
- 当失败高风险或外部阻塞时升级到人工

除非您通过当前环境中的实际工具实际执行它们,否则不要声明不受支持的自愈操作,如"重置智能体状态"或"更新工具配置"。

受控恢复清单:

```markdown
## 恢复操作
- 选择的诊断:
- 采取的最小操作:
- 为什么这是安全的:
- 什么证据将证明修复有效:
```

### 阶段 4:内省报告

以使恢复对下一个智能体或人类可读的报告结束。

```markdown
## 智能体自我调试报告
- 会话 / 任务:
- 失败:
- 根本原因:
- 恢复操作:
- 结果:success | partial | blocked
- 令牌 / 时间消耗风险:
- 需要跟进:
- 稍后编码的预防性变更:
```

## 恢复启发式

按顺序优先考虑这些干预:

1. 用一句话重新陈述真实目标。
2. 验证世界状态而非信任记忆。
3. 缩小失败范围。
4. 运行一次判别检查。
5. 只有那时重试。

坏模式:
- 用略微不同的措辞重试相同的操作三次

好模式:
- 捕获失败
- 对模式进行分类
- 运行一次直接检查
- 仅当检查支持时更改计划

## 与 ECC 集成

- 如果更改了代码,在恢复后使用 `verification-loop`。
- 当失败模式值得转化为本能或稍后技能时,使用 `continuous-learning-v2`。
- 当问题不是技术失败而是决策模糊时,使用 `council`。
- 如果失败来自冲突的本地状态或存储库漂移,使用 `workspace-surface-audit`。

## 输出标准

激活此技能时,不要仅以"我修复了它"结束。

始终提供:
- 失败模式
- 根本原因假设
- 恢复操作
- 情况现在更好或仍然受阻的证据

Versions

RepositoryScoreLicence
This page · aaione/everything-claude-code-zh96MIT
affaan-m/ECC100MIT
SHRIJANAGAIN/Nemo-Cli100Apache-2.0
affaan-m/ECC96MIT
aaione/everything-claude-code-zh96MIT

Database snapshot: 13.11.2026 · package version d08932547e3c (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90introspection
    自分自身またはAIエージェントの判断・認識・信念・暗黙の前提を吟味する内省スキル。『なぜそう考えたか』『何を当然視していたか』『自分の判断を内省して』『思考の癖を調べて』『self-reflection』『examine assumptions』など、自分の認識過程を検討するときに使う。成果物そのものの良し悪しの批評、一般的な原因分析、行動計画の策定、振り返り全体の代替としては使わない。
  • 100debugging-workflows
    Debug workflow execution issues including syntax errors, agent failures, variable problems, and execution errors. Use when workflows fail, produce unexpected results, or user asks for debugging help.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.