关于 no-workarounds
no-workarounds 是一项指导修复诊断失败和软件缺陷的技能,重点是找到并修正根因,而不是隐藏问题。它强调验证原始故障、保持修复范围,并在外部缺陷无法修正时明确隔离限制。
主要功能
- 01追踪故障至所属代码或边界
- 02审查抑制项与错误处理方式
- 03区分缺陷修复和必要兼容适配
- 04聚焦修复并复用现有工具
- 05通过现有测试验证结果
适用场景
- 01替代屏蔽诊断的临时修补
- 02排查被吞掉的错误或回退链
- 03在边界隔离外部依赖缺陷
- 04验证修复没有改变原有行为
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ marcioaltoe/ 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