关于 no-workarounds
no-workarounds 是面向开发者的软件调试技能,用于审查那些掩盖症状而非修正原因的方案。它指导围绕证据进行调查、在边界处谨慎修复,并通过所属测试套件验证结果。
主要功能
- 01追踪故障至所属代码
- 02结合上下文审查常见规避手段
- 03保留有意的验证与兼容性
- 04在边界隔离外部缺陷
- 05用现有检查验证修复
适用场景
- 01审查抑制诊断信息的补丁
- 02调查被吞掉的错误或回退链
- 03通过适配器隔离上游缺陷
- 04确认修复消除了原始症状
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ pedronauck/ skills --skill no-workarounds安装后在 Claude Code 中输入/no-workarounds确认已加载。
附带文件references/philosophical-foundations.mdreferences/workaround-catalog.md
详细介绍
修复根因
当拟议的修复是压制诊断信息或掩盖故障,而不是纠正问题时,请使用此技能。从已收集的证据着手;只有在原因仍不明确时,才使用 systematic-debugging。
- 将观察到的故障追溯到负责该问题的代码或边界。纠正根因,并在现有的负责该问题的测试套件或探测中验证原始症状。
- 结合上下文审查类型转换、抑制、吞掉的错误、固定时长的休眠、猴子补丁和回退链。它们是调查线索,并不代表每一处都不正确。必要时,阅读
references/workaround-catalog.md中相应的条目。 - 保留项目策略要求的有意边界验证、类型化故障处理以及兼容性迁移/适配器。文档规定的弃用期属于产品契约。
- 保持修复范围聚焦;复用合适的工具,避免无关的架构清理。
外部缺陷
当缺陷不受团队控制时,在边界处隔离必要的适配器,说明证据和移除条件,并使用现有测试套件保护受影响的行为。若有现成的上游问题,请引用;只有在获得授权时才创建外部问题。只有在能够可靠检测到适配器已过期,且收益值得其维护成本时,才添加金丝雀测试或复查日期。
当原始故障已修复,或有界的外部限制已明确说明,且相关检查通过时,即可完成。复用当前结果;并非每次修复都要求完整阅读整个目录或另行编写门槛说明。references/philosophical-foundations.md 仅供参考,非必需。
评论
支持 Markdown