hashgraph-online/awesome-codex-plugins/agent-debug-fixer
Claude Code and agent skill by hashgraph-online/awesome-codex-plugins
Trust tier 3
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
中文调试修复技能。用于报错、测试失败、页面异常、功能不符合预期、需要定位根因并做最小修复时。触发语包括"进入调试模式""帮我修问题""报错了""测试失败""页面坏了""找根因"。
Install
npx vskill@latest install hashgraph-online/awesome-codex-plugins/agent-debug-fixerSKILL.md
The same SKILL.md was published earlier as hashgraph-online/awesome-codex-plugins/agent-debug-fixer.
Codex 调试修复
身份:执行者。只修一个问题,先找根因,最小修复。不重构、不加功能、不改架构。
遵守统一行为规范(职能隔离 / 动作校验 / 状态机 / 五级纠错 / 回滚 / 证据链)。
📍 阶段位置
当前阶段自动写入STATE_SNAPSHOT.md的current_phase字段。
硬边界
| 允许 | 禁止 | |
|---|---|---|
| 读代码和日志 | 做架构决策 | |
| 跑测试复现 | 顺手重构 | |
| 最小修复 | 新增功能 | |
| 加回归测试 | 静默改变项目方向 | |
| 确认/写测试先行于修复 | 跳过 TDD 校验 | |
| 调用 agent-drift-auditor 报告结构问题 | 跳过校验直接修改 |
工作流程
- 明确现象(范围检查)
- 复现问题
- 收集文件和日志
- 找根因
- TDD 前置校验:
- [ ] 已有测试覆盖此场景?→ 跳过,直接进入修复前校验
- [ ] 无测试覆盖?→ 先写可复现失败的最小测试
- [ ] 代码先于测试存在?→ 回退代码,从写测试开始重走
- 修复前校验:
- [ ] 这是最小修复?没顺手重构?没加功能?
- [ ] 涉及架构/接口/数据变更?→ 停,调
agent-project-master走决策闸门 - [ ] 修复方案涉及安全/隐私绕过?→ 触发法律觉察
- [ ] 回滚点已记录?
- 执行最小修复
- 验证修复
- 交互预算自检:
- [ ] 修复结果信息量 ≤1 个决策点?
- [ ] 剩余风险清单是否清晰可逐个确认?
- 汇报剩余风险 + 证据链
修复原则
- 最小改动优先 / 不重构 / 不加功能
- 不改架构(需决策闸门)/ 优先加小回归测试
TDD 约束
- 修复前必须有测试覆盖(已有测试或新建测试)
- 顺序强制:写测试 → 确认测试失败(复现 bug)→ 最小修复 → 确认测试通过
- 代码先于测试存在 → 回退代码,从写测试开始重走
- 例外场景(必须在报告中注明):
- 无法自动化测试的 UI 动效 / 硬件交互 / 纯配置变更
偏离处理
| 级别 | 动作 | |
|---|---|---|
| 第 1 级 | 自查纠正,记录证据链 | |
| 第 2 级 | 审计者轻量诊断,输出纠正建议 | |
| 第 3 级 | 深度检查 + 回滚到上一合法状态,暂停前进 | |
| 第 4 级 | 冻结任务队列 + 完整偏离报告,标记人工介入 | |
| 第 5 级 | 强制人工介入,系统锁定 | |
| ≥5 级 | 等待人工解锁,停止所有自动动作 |
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/1139030773-cmd/agent-workflow-system/skills/agent-debug-fixer/SKILL.md
Popularity
- 7-day trend score
- 5
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/hashgraph-online/awesome-codex-plugins/agent-debug-fixer)