debug-fixer

debug-fixer is a skill for Claude Code, Codex from 1139030773-cmd/agent-workflow-system. It costs 36 tokens per session (1,079 once invoked), scanned A, original, MIT.

A Chinese-language debugging assistant for fixing one reported software problem with the smallest necessary change.

In plain words
What is it for?
It investigates errors, failed tests, and unexpected page or feature behavior, adds regression tests, applies a minimal fix, and sends larger design issues for separate planning.
Why use it?
It keeps debugging focused by requiring reproduction, a failing test when needed, root-cause analysis, and verification before completion.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/1139030773-cmd/agent-workflow-system/debug-fixer
Any agent
npx skills add 1139030773-cmd/agent-workflow-system --skill debug-fixer
Clone the repo
git clone --depth 1 https://github.com/1139030773-cmd/agent-workflow-system

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for debug-fixer

README.md
[![agentmods](https://agentmods.dev/badge/skills/1139030773-cmd/agent-workflow-system/debug-fixer.svg)](https://agentmods.dev/skills/1139030773-cmd/agent-workflow-system/debug-fixer)
Your own site
<a href="https://agentmods.dev/skills/1139030773-cmd/agent-workflow-system/debug-fixer"><img src="https://agentmods.dev/badge/skills/1139030773-cmd/agent-workflow-system/debug-fixer.svg" alt="Measured on agentmods" height="20"></a>
Per session 36 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,079 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00036 $0.01079
Opus 5 $0.00018 $0.00540
Sonnet 5 $0.00007 $0.00216
Haiku 4.5 $0.00004 $0.00108

Measured 4d ago against content hash ea2213d5b315, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

debug-fixer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/debug-fixer/SKILL.md · 93 lines

What it actually says

调试修复

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

遵守 references/BEHAVIOR_SPEC.mdreferences/STATE_MACHINE.mdreferences/EVIDENCE_CHAIN.md

📦 Artifact 交接

输入 输出
plan.md patch.md(模板: references/artifacts/patch.md

只读 plan.md + plan 中指定的文件范围。不读 plan 禁止修改的文件。不重新遍历项目。

📍 阶段位置

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

当前阶段自动写入 STATE_SNAPSHOT.mdcurrent_phase 字段。

启动自检

  1. 读取 BEHAVIOR_SPEC.md 第一章:确认执行者边界
  2. 读取 STATE_MACHINE.md:确认当前状态合法
  3. 读取 TASK_QUEUE.mdSTATE_SNAPSHOT.md
  4. 偏离计数器清零
  5. 恢复感知(若为恢复会话):确认 RESUME.md 中 phase 字段匹配当前技能,不匹配时报告 workflow-system

硬边界(执行者 == 修问题,不扩张)

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

工作流程

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

修复原则(BEHAVIOR_SPEC.md §2.4)

  • 最小改动优先 / 不重构 / 不加功能 / 不改架构
  • 优先加小回归测试

TDD 约束

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

偏离处理(BEHAVIOR_SPEC.md 第四章)

次数 动作
第 1 次 自查,回滚
第 2 次 /drift-auditor 深度审计
第 3 次 冻结 → 人工介入
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 93 lines · 36 tokens per session scan A ea2213d5b315

Subscribe to this mod's changes

debug-fixer is a skill published in the GitHub repository 1139030773-cmd/agent-workflow-system (5 stars, last pushed 2mo ago), licensed MIT. It adds 36 tokens to every session and 1,079 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

zu-article-image-skill

为已完成的 Markdown 文章设计语义配图位置,按内置 preset/type/style/palette 样式体系生成可编辑自然语言生图 Prompt,并作为隐藏标签插入文章;用户确认后扫描标签,调用当前运行时原生 imagegen 生成图片并插回文章。用于用户要求为文章配图、规划正文插图、调整文章插图风格或根据文章内 Prompt 标签生成图片时。.

wwenj/zu-article-image-skill · 100 tokens

design-taste-frontend

Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right design direction, and ships interfaces that do not look templated. Real design systems when applicable, audit-first on redesigns, strict pre-flight check.

Leonxlnx/taste-skill · 61 tokens

image-to-code

Elite website image-to-code skill for Codex. For visually important web tasks, it must first generate the design image(s) itself, deeply analyze them, then implement the website to match them as closely as possible. In Codex, it must prefer large, readable, section-specific images instead of tiny compressed boards…

Leonxlnx/taste-skill · 116 tokens

design-taste-frontend-v1

The original v1 taste-skill, preserved for projects depending on its exact behavior. The current default is design-taste-frontend (v2 experimental), which is a substantial rewrite. Use this v1 install name only if you need exact backward compatibility.

Leonxlnx/taste-skill · 61 tokens

brandkit

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional…

Leonxlnx/taste-skill · 89 tokens

redesign-existing-projects

Upgrades existing websites and apps to premium quality. Audits current design, identifies generic AI patterns, and applies high-end design standards without breaking functionality. Works with any CSS framework or vanilla CSS.

Leonxlnx/taste-skill · 45 tokens