AGENT SKILL

systematic-debugging

提供系统化根因定位流程,避免在复杂缺陷里靠猜测叠加修补。 当问题难复现、跨模块、连续修错或需要先证明根因再改代码时使用。

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
systematic-debugging
description
提供系统化根因定位流程,避免在复杂缺陷里靠猜测叠加修补。 当问题难复现、跨模块、连续修错或需要先证明根因再改代码时使用。

02 资源文件 1

03 SKILL.md 正文

Systematic Debugging

用途

  • 把“先猜一个修法试试”改成“先收敛证据、再验证假设”。
  • 适合复杂仓库、跨边界链路、间歇性问题和连续修错的场景。

默认做法

  1. 先冻结“继续乱改代码”的冲动,收敛最小复现、错误现象、最近变更和影响边界。
  2. 从症状沿数据流、调用链或状态变化往回追,找出第一个与预期不一致的点,而不是只盯最终报错位置。
  3. 每轮只保留一个最强根因假设;用额外日志、断言、最小实验或对照路径去证伪它。
  4. 只有在根因被证实时才落修复;修复优先配套失败用例、稳定复现脚本或明确回归检查。
  5. 修复完成后,把验证结果回交实现角色、QA 或 /verify,不要让调试结论停留在个人上下文里。

触发信号

  • 已经尝试 2 次以上修改,但问题仍未消失或出现新副作用。
  • 报错位置明显只是表象,真实原因可能在上游输入、配置、状态同步或依赖边界。
  • 问题涉及多个模块、线程、服务、浏览器状态或异步链路。
  • 需要先证明根因,才能决定是改代码、补测试、修配置还是升级处理。

配套约束

  1. 先收敛入口、边界、相关规则和已有实现,再开始下判断。
  2. 需要把修复闭环跑完时,接 /verify 或相应测试流程。
  3. 涉及线上故障、止血或跨团队协调时,并行遵循事故分级、升级与同步 runbook。
  4. 若连续 3 轮假设都被证伪,或怀疑涉及架构/需求层错误,升级给 tech-lead 或 architect,不要继续叠加试错。

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k