AGENT SKILL
principle-fix-root-causes
调试时适用。把每个症状追溯到系统首次出错的地方并修复;只有守卫处理的状态确实合法时,守卫才算修复。
- License 许可
- MIT
- 最近更新
- 2026-10-21
- Stars
- ★ 3
- Forks
- 0
01 前言 Front Matter
- name
- principle-fix-root-causes
- description
- 调试时适用。把每个症状追溯到系统首次出错的地方并修复;只有守卫处理的状态确实合法时,守卫才算修复。
- disable-model-invocation
- true
03 SKILL.md 正文
修复根因
调试时,要修故障本身,而不是它暴露出来的位置。症状是错误状态显现出来的地方。根因是系统第一次做了不该做的事,或第一次没有处理本应处理的状态的地方。
原因: 修复症状会掩盖证据,故障仍会在别处暴露。每修一次症状,系统就更难推理,因为代码里多了临时处理,却没人说清它针对哪个 bug。
模式:
- 先复现。
- 在每一步都问「为什么」,直到答案指向代码里的错误决策,而不是更早决策造成的后果。
- 卡住时就插桩。读取实际错误和实际状态。不要猜。
- 先问触发症状的状态是否合法。如果系统可能处于这种状态,在这种状态下出错的代码就是根因,在那里处理这种状态就是修复。如果这种状态根本不应存在,在出错处加检查只会掩盖 bug。找出产生这种状态的代码。守卫、重试、吞掉错误、钳制数值和丢弃状态,都是常见的 bug 掩盖方式。
- 只在重启后失败时,先怀疑持久化状态:配置文件、缓存、锁文件、序列化状态。
- 查模式,不只查实例。找出所有存在相同故障的地方,一并修复。
- 如果临时处理需要一长段注释才能自圆其说,代码就是错的。修代码,不是修注释。
- 若决定性的事实要深挖才找得到,就提出一条便宜、一直开着的信号,让人第一眼就能看见它。
04 同仓库更多 Skills
why
用于「为什么 X 是这样实现的」「为什么选了 Y」、设计理由、回归、事后复盘,或数据支撑的阈值问题。发现可用 MCP 并并行查询各证据类别(源码控制、工单跟踪、长文文档、实时聊天、基础设施可观测性、错误跟踪、产品分析数仓),然后返回带引用的决策与权衡解读。运行时行为请用 how。
★ 3
unslop
从任意写作中剔除 AI 痕迹。
★ 3
typescript-best-practices
TypeScript 最佳实践。读取或编辑任意 .ts 或 .tsx 文件时使用。
★ 3
technical-writing
分层技术写作标准:Diátaxis 结构、Google 开发者风格句子、STE 指令规则、Global English 句法。用于 /technical-writing,或撰写/审查文档、RFC、README、PR 描述、commit message 时。
★ 3
teach
用平实语言解释一段工作,让人真正理解。运行 how 与 why skill,把发现织成一份清晰说明。用于「teach me this」「help me really understand X」「explain this change or subsystem to me」。
★ 3
tdd
仅当用户明确要求 TDD、失败测试或回归测试时使用,或 bug 有明显且廉价的本地测试目标时使用。测试路径不清、昂贵、偏集成或未要求时跳过。
★ 3