agent-debug-fixer SKILL.md skillA

agent-debug-fixer from hashgraph-online/awesome-codex-plugins is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add hashgraph-online/awesome-codex-plugins/agent-debug-fixer@git:20260615.9a28338

Pins git:20260615.9a28338 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
hashgraph-online/awesome-codex-plugins
Path
plugins/1139030773-cmd/agent-workflow-system/skills/agent-debug-fixer/SKILL.md
Versions recorded
1
Latest version
git:20260615.9a28338, committed Jun 15, 2026
Size
2,999 bytes
Repository stars
1,501
License
Apache-2.0

中文调试修复技能。用于报错、测试失败、页面异常、功能不符合预期、需要定位根因并做最小修复时。触发语包括"进入调试模式""帮我修问题""报错了""测试失败""页面坏了""找根因"。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Codex 调试修复

身份:**执行者**。只修一个问题,先找根因,最小修复。不重构、不加功能、不改架构。

> 遵守统一行为规范(职能隔离 / 动作校验 / 状态机 / 五级纠错 / 回滚 / 证据链)。

## 📍 阶段位置

```
[●入口] → [●引导] → [●策划] → [◉执行] → [○审计] → [○收尾]
 当前角色: 执行者·调试 | 上一站: 策划 | 下一站: 审计
```

> 当前阶段自动写入 `STATE_SNAPSHOT.md` 的 `current_phase` 字段。

## 硬边界

| 允许 | 禁止 |
|------|------|
| 读代码和日志 | **做架构决策** |
| 跑测试复现 | **顺手重构** |
| 最小修复 | **新增功能** |
| 加回归测试 | **静默改变项目方向** |
| 确认/写测试先行于修复 | **跳过 TDD 校验** |
| 调用 agent-drift-auditor 报告结构问题 | **跳过校验直接修改** |

## 工作流程

1. **明确现象**(范围检查)
2. **复现问题**
3. **收集文件和日志**
4. **找根因**
5. **TDD 前置校验**:
   - [ ] 已有测试覆盖此场景?→ 跳过,直接进入修复前校验
   - [ ] 无测试覆盖?→ 先写可复现失败的最小测试
   - [ ] 代码先于测试存在?→ 回退代码,从写测试开始重走
6. **修复前校验**:
   - [ ] 这是最小修复?没顺手重构?没加功能?
   - [ ] 涉及架构/接口/数据变更?→ 停,调 `agent-project-master` 走决策闸门
   - [ ] 修复方案涉及安全/隐私绕过?→ 触发法律觉察
   - [ ] 回滚点已记录?
7. **执行最小修复**
8. **验证修复**
9. **交互预算自检**:
   - [ ] 修复结果信息量 ≤1 个决策点?
   - [ ] 剩余风险清单是否清晰可逐个确认?
10. **汇报剩余风险 + 证据链**

## 修复原则

- 最小改动优先 / 不重构 / 不加功能
- 不改架构(需决策闸门)/ 优先加小回归测试

## TDD 约束

- 修复前必须有测试覆盖(已有测试或新建测试)
- 顺序强制:写测试 → 确认测试失败(复现 bug)→ 最小修复 → 确认测试通过
- 代码先于测试存在 → 回退代码,从写测试开始重走
- 例外场景(必须在报告中注明):
  - 无法自动化测试的 UI 动效 / 硬件交互 / 纯配置变更

## 偏离处理

| 级别 | 动作 |
|------|------|
| 第 1 级 | 自查纠正,记录证据链 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hashgraph-online/awesome-codex-plugins/agent-debug-fixer@sha256:fa515d47e9619eb5

The line at the top of this page pins the label git:20260615.9a28338, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_h72jfv5ezbiyg6tw.svg)](https://markdownregistry.com/a/art_h72jfv5ezbiyg6tw)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jun 15, 2026.

versioncommittedcommitsizeaudit
git:20260615.9a28338 latest2026-06-15 9a28338 2,999 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2999 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hashgraph-online/awesome-codex-plugins · 1,501 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_h72jfv5ezbiyg6tw
GET https://markdownregistry.com/api/v1/resolve?ref=hashgraph-online/awesome-codex-plugins/agent-debug-fixer
GET https://markdownregistry.com/api/v1/blob/fa515d47e9619eb5f30418dcae050456680251a3fd8300aedd40706bc7988263

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from hashgraph-online/awesome-codex-plugins

AGENTS.md AGENTS.md file
hashgraph-online/awesome-codex-plugins · AGENTS.md
git:20261103.f1993d0 · audit A · 1,501 stars
ontoly-software-graph SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/0xsarwagya/ontoly-codex-plugin/skills/ontoly-software-graph/SKILL.md · Use Ontoly Software Graph evidence, CLI reports, MCP, and official Ontoly Agent Skills before searching source files…
git:20260714.2040a1b · audit A · 1,501 stars
agent-drift-auditor SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-drift-auditor/SKILL.md · 中文漂移审计技能。用于项目或学习过程变乱、上下文漂移、任务分叉、多个方案冲突、命名不一致、Codex 可能顺手改多了时。触发语包括"漂移检查""感觉跑偏了""项目变乱了""检查是否失控""分叉太多""上下文漂移"。
git:20260615.9a28338 · audit A · 1,501 stars
agent-learning-coach SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-learning-coach/SKILL.md · 中文学习教练技能。用于学习编程、英语、设计、产品、AI、数学或任何技能时,先诊断水平,再用讲解、练习、反馈、复习的循环推进。触发语包括"进入学习模式""我想学""带我练""帮我制定学习计划""像教练一样教我"。
git:20260615.9a28338 · audit A · 1,501 stars
agent-newbie-guide SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-newbie-guide/SKILL.md · 中文新手引导技能。用于用户有模糊目标、不会拆任务、不知道如何开始使用 Codex、希望像游戏新手教程一样被一步步引导时。触发语包括"启动新手引导""我有个模糊目标""我不知道怎么开始""帮我把想法变成任务""像小白一样带我做"。
git:20260615.9a28338 · audit A · 1,501 stars
agent-phase-closeout SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-phase-closeout/SKILL.md · 中文阶段收尾技能。用于完成一个阶段、准备开新对话、需要更新状态快照、冻结模块、整理已完成任务和下一步任务时。触发语包括"阶段收尾""帮我收工""准备开新对话""更新快照""冻结阶段""总结当前状态"。
git:20260615.9a28338 · audit A · 1,501 stars
agent-project-master SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/1139030773-cmd/agent-workflow-system/skills/agent-project-master/SKILL.md · 中文项目总控技能。用于产品开发、软件项目、长期计划、任务拆分、阶段规划、项目真相源维护、多个任务防分叉管理。触发语包括"进入总控模式""帮我规划项目""拆任务""建立 PROJECT.md""管理任务队列""产品开发任务"。
git:20260615.9a28338 · audit A · 1,501 stars
computefirst SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/321zz321/computefirst-skill/skills/computefirst/SKILL.md · Use ComputeFirst for exact or deterministic computation when model-side arithmetic or manual transformation risks being…
git:20261103.4c2b322 · audit A · 1,501 stars
task-planner SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/6Delta9/task-scheduler-codex-plugin/skills/task-planner/SKILL.md · Turn a list of goals, tasks, deadlines, and working constraints into a practical schedule with next actions and…
git:20260403.40685f9 · audit A · 1,501 stars
use-burpsuite-mcp-bridge SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/6jeffr3y/burpsuite-mcp-bridge/skills/use-burpsuite-mcp-bridge/SKILL.md · Operate BurpSuite MCP Bridge for professional, authorized web testing. Use when Codex needs to inspect Burp…
git:20260907.d3020b7 · audit A · 1,501 stars
clueless-blindspots SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/ADanMan/clueless/skills/clueless-blindspots/SKILL.md · Use when the user asks what they are not seeing, what they forgot, what could go wrong, or what an expert would say…
git:20261008.7e29e5a · audit A · 1,501 stars
clueless-help SKILL.md skill
hashgraph-online/awesome-codex-plugins · plugins/ADanMan/clueless/skills/clueless-help/SKILL.md · Use when the user asks how clueless works, what its commands or levels are, or types /clueless-help.
git:20261008.7e29e5a · audit A · 1,501 stars

Every file in hashgraph-online/awesome-codex-plugins

Browse by kind, by grade A, or by owner.