SuperAPI AI 工具集

no-deferred-work

编程与开发

查看项目

更新于 10-16 05:42

技能介绍

用途:这是一条贯穿所有开发过程的纪律性技能,核心原则是“被推迟的工作就是被遗忘的工作”。它要求在编写和提交代码时不留下任何延后标记,要么现在完成,要么先获得明确的推迟许可。

主要能力与规则:禁止提交 TODO、FIXME、HACK、XXX 等注释;禁止占位实现(如返回空对象或直接返回 true 的假校验);禁止不完整的错误处理与缺失的测试。规则是:若工作在当前任务范围内,立即完成;若确实属于范围外,需创建单独议题并引用,而不是留下注释。

决策方式:实现中发现新工作时,先判断是否在当前议题范围内。是则立即做;否则判断能否在不做它的情况下完成当前工作。能则为其创建独立议题,不能则扩大范围立即做,然后提交。错误处理要完整区分校验错误、数据库错误等并给出面向用户的提示;新代码要补齐边界测试。

例外流程:确需推迟时(很少见),先向协作者明确请求许可,说明当前议题、发现的工作及可选项;获批后创建包含完整描述、验收标准和发现来源链接的正式议题,并在代码中引用该议题编号,而非写 TODO。

检测与集成:可配置 pre-commit 钩子扫描暂存差异中的 TODO/FIXME/HACK/XXX 并阻止提交;代码评审应拒绝含延后标记、占位实现、不完整错误处理或缺少测试的 PR。该技能被 issue-driven-development 第 7 步和 comprehensive-review 采用。

适用场景:适用于需要控制技术债、避免功能残缺与生产问题的工程团队与个人开发流程。

限制:资料未提供该技能的安装命令、具体平台适配方式或收费信息,暂未提供。