用途:为所有编写或评审的代码提供统一的“代码形态”政策,追求以最少代码、最低复杂度解决问题,而非最聪明或最可扩展的方案。每条规则都写成可运行的检查,而非口号。仓库已有标准(CLAUDE.md、AGENTS.md、runbooks/、贡献文档、lint 配置)始终优先于本基线,本技能只填补空白。
主要能力(测试):删除测试——假设删除该模块/抽象/层,若复杂度消失则为直通层应真删;两个适配器规则——除非今天确实存在两个实现,否则不引入接口、策略、插件点或配置开关(YAGNI,反对“以后可能需要”);内联测试——若在调用点内联后总代码更少则内联;diff 测试——diff 中每个改动块都须为既定目标所需,顺带重构应拆成单独提交,唯一例外是同步更新相关文档;解释测试——能两句话讲清设计,否则过于聪明(KISS);新依赖测试——新包须比新代码门槛更高,仅当维护良好、解决真正困难问题且手写超过 100 行时才引入。删除代码是最好结果。
气味基线(Fowler 精简):投机性泛化—删到需要为止;中间人—内联;神秘命名—改名;重复代码—第二次真实出现时才提取;依恋情结—移到数据所在模块;数据泥团—引入对象;基本类型偏执—引入类型;重复 switch—多态/查表;散弹式修改—合并关注点;发散式变化—拆分关注点;消息链—隐藏遍历;沉积层—删除,git 记得。
反馈协议:若请求、计划阶段或现有模式未通过测试,应在起草计划前、实现前、评审时提出一次具体反对并附更简单替代方案,之后尊重决定。
团队标准持久化:项目根目录用 runbooks/ 存放团队标准,结构为 runbooks/index.md 加 runbooks/<slug>.md 或 runbooks/<name>/<slug>.md,每个 runbook 只讲当前行为。CLAUDE.md/AGENTS.md 中加一行指向每个 runbook 的链接,未被引用的 runbook 等于死重;不要新建这两个文件,只编辑已存在的那个。
适用场景:编写代码(任何执行器)、评审代码、规划阶段。限制:资料未提供具体安装命令、版本、价格、平台支持或效果数据;不明确项暂未提供。