SuperAPI AI 工具集

no-workarounds

测试与质量

查看项目

更新于 10-16 03:17

技能介绍

用途:no-workarounds 是一个面向全部软件工程任务的技能规范,核心主张是:任何让问题不再显现却没有解决其存在原因的改变都属规避(workaround),应当改为根因修复。它适用于调试缺陷与测试失败、修复错误或异常行为、规划实现方案、审查代码变更、解决构建/lint/类型检查失败、架构决策、性能问题和响应代码审查反馈,也特别适用于时间压力大、看似存在“快速修复”、修改他人代码或测试间歇性失败的场景。

主要能力与用法:提供“规避检测门”流程——先陈述问题,追问问题为何存在,追踪根因(可配合 systematic-debugging 技能),判断修复是否针对根因、若代码本身正确是否仍需要该改动、是否在压制信号而非修复源头;若答案显示只是修补症状则停止并重新设计。文档归纳七类规避:类型系统规避(as/any/unknown/!)、lint 与警告抑制(eslint-disable、@ts-ignore)、错误吞没(空 catch、默认值掩盖损坏数据)、时序与生命周期 hack(setTimeout、sleep、盲目重试)、猴子补丁与运行时改型、防御性重复(散布可选链替代边界校验)、复制粘贴式改写。每类都给出前置判断问句、正确修复方向及少量前后对比示例。此外提供“逃生阀”条件:仅当根因确在团队无法控制的外部代码、上游修复时间不确定、不发布业务代价高于技术债、且规避被隔离时才允许,并须加 // WORKAROUND 注释、建跟踪 issue、补测试与金丝雀测试、设不超过 90 天的复审日期。还有复合成本公式、常见合理化借口对照、决策树及与其他技能的集成说明。

使用方式与限制:以技能说明文本形式使用,激活后按各分类的门控问句审查代码改动,不提供可执行代码或安装命令。资料未给出独立运行方式、收费、价格、支持平台或效果数据,这些暂未提供。详细模式目录与工程哲学需阅读所引用的 references 文件。