SuperAPI AI 工具集

kill-slop

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:kill-slop 用于约束 AI 编程智能体的产出质量,核心目标是强制生成最小、可直接合并的改动,优先选择能完整解决既定任务的最小修改。

主要能力与硬性规则:不得在任务不明确需要时创建文件;不得添加用户未要求、现有代码也未使用的依赖;不得顺手重构无关代码;不得添加复述代码含义的注释;不得为单次使用引入抽象(包装器、辅助函数、工厂、utils);不得扩大用户请求范围;不得凭空生成 TODO、桩代码或“以后再说”的脚手架;不得在用户未明确要求时搜索、列出或读取工作区根目录之外的内容;不得浏览同级项目、主目录、桌面或历史对话找“模式”或灵感;不得在仓库未使用时凭空搭建 Clean Architecture / SOLID 目录树。必须优先匹配现有项目模式,优先编辑已有文件而非新增,必须删除自己引入的死代码。

用户意图优先:默认最小化;若用户明确要求更多结构(如 Clean Architecture、完整项目脚手架、添加某依赖、抽取共享抽象、写测试或加解释性注释),则遵从该明确要求。要求含糊时倾向最小化,并说明跳过了什么。

文件拆分(可导航性):默认就地放置,编辑已负责该关注点的文件/目录。仅当同时满足“当前已难以导航(约 300–400 行以上或混杂无关关注点)”“抽取的是单一内聚单元且有清晰命名”“新文件遵循附近已有模式”三条时才拆分。拆分时必须与相关代码同目录、修正导入、不留下“方便用”的死再导出,改动不得波及全仓库重组。不确定时不要拆分,并在总结中说明。全新项目倾向扁平结构,直到真正出现导航困难。

Diff 预算与检查:写代码前先确定一句话目标、最少触及文件清单和非目标。小任务触及文件超过约 5 个时应停下缩小计划。收尾时在目标仓库目录运行随附的只读检查脚本:bash <path-to-this-skill>/scripts/check-diff.sh,可选参数 --max-files 5(默认)、--base HEAD。状态分为 OK(在软文件预算内)、OVER_BUDGET(需先缩减)、SKIP(无 git 或无基线,需手动按同样约 5 文件规则计数)。若用户明确要求大型脚手架,应遵从用户要求,不因 OVER_BUDGET 而忽略。

风格与自检:偏好朴素可读代码而非炫技;只处理任务需要的真实错误路径;命名应表达意图,需要注释时优先改名;仅在仓库已有该区域测试或用户要求时写测试。收尾前自查每行改动是否服务于目标、是否有可内联的新文件、新文件是否只为可导航性、是否位于相关代码旁并匹配仓库布局、是否新增依赖、是否有顺手重命名/移动/重构、是否有显然注释、是否有工作区外读取、整体 diff 是否达到资深工程师可直接合并的水准,以及用户明确要求的架构/依赖/测试/布局是否被尊重。

适用场景:适用于使用 AI 编程智能体进行日常开发、代码评审或审核智能体产出的团队与个人。

限制:资料未提供该技能的具体安装命令、支持的平台与工具集成、收费方式、许可证及效果数据,这些信息暂未提供。