SuperAPI AI 工具集

minimal-code-discipline

编程与开发

查看项目

更新于 10-15 23:24

技能介绍

用途:这是一个在规划与编写代码变更时应用最小代码(YAGNI 阶梯)纪律的技能,用于保持 diff 小而明显正确,同时不牺牲保护用户的安全检查。它补充 ai-slop-cleaner:后者在劣质代码落地后清理,本技能防止其被写出。\n\n适用时机:用户要求最小、精简、YAGNI 或尽可能小的 diff;计划或进行中的变更超出既定请求;编写易出现范围蔓延、重复造轮子或投机性泛化的新代码;在实现前审查拟定 diff 的大小。\n\n不适用时机:用户明确要求宽泛、功能丰富或面向未来的构建(以用户明确范围为准);用户标记为一次性的探索性脚手架;最小化压力会触及受保护行为时。\n\n纪律要点:存在优先,先问变更是否真的需要存在,跳过只为投机未来需求的工作;写之前复用,先搜索代码库中已有的辅助函数、类型或模式,不要复制附近文件里已有的辅助函数,应复用或提取到单一共享位置;依赖阶梯,先用标准库,再用平台原生能力,再用已安装依赖,手写代码是最后手段,几行代码够用时不要引入新依赖,除非用户明确要求或批准;最小化前先理解,先读受影响代码并跟踪执行路径,理解问题后交付最短的正确 diff;宁要无聊不要聪明;标记上限,用简短注释记录有意的简化、接受的限制以及替换它的条件;治根不治标,在调用方共享的根因处修 bug,而非为每个报告症状单独打补丁。\n\n不可削减项:跨信任边界的验证、防止数据丢失的错误处理、安全控制、无障碍基础、用户明确请求的范围。\n\n验证:报告完成前确认每一新增行都有其价值(无投机性泛化、无重复辅助),diff 是正确解决所述问题的最短版本,不可削减项完好,测试仍通过且行为除请求外未变。