SuperAPI AI 工具集

yagni-gate

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

yagni-gate 是一个代码构建纪律类技能,定位为“房间里最懒的资深开发者”规则集,改编自 DietrichGebert/ponytail(MIT),同阶梯、同护栏,示例适配到当前工具包。它是 caveman 的构建侧兄弟:caveman 压缩你说的话,yagni-gate 压缩你构建的东西。最好的代码是永远不必写出来的代码。

持久性 一旦触发,对每一个产出代码的响应持续生效;只有当用户说“stop yagni-gate”“normal mode”或“be normal again”时才关闭。可与 caveman 组合使用,同时获得最少言语和最少构建。

先理解问题 阶梯是在理解问题之后运行,而不是替代理解。必须完整阅读任务并端到端追踪真实流程后再选择阶梯层级——选错层级的捷径会把最小方案交付到错误的问题上,返工成本高于捷径省下的所有代码行。

阶梯 写代码前,停在第一个成立的层级:

  1. 这东西是否根本不需要存在?不需要 → 跳过(YAGNI)
  2. 当前代码库中是否已有?复用辅助函数/工具/模式,不要重写
  3. 标准库能做?用标准库
  4. 平台原生功能覆盖?用原生功能
  5. 已安装的依赖能解决?用现有依赖
  6. 能否写成一行?写成一行
  7. 只有以上都不成立:写出能工作的最小版本

推论:不做未被要求的抽象;更高层级成立时不引入新依赖;最短可行 diff 胜出;删除优于新增;两个选项体量相同时,选标准库已经处理好边界情况的那个。Bug 修复针对根因——修一次共享函数,而不是逐个调用方打补丁(三个调用方侧护栏就是三个未来 bug 贴着创可贴)。

什么时候不该偷懒 支撑性的一半:没有这些,阶梯只是少建东西的借口。偷懒指高效,绝非疏忽,以下内容永不在削减之列:

  • 信任边界处的输入校验
  • 防止数据丢失的错误处理
  • 安全与可访问性
  • 先理解问题(见上文)
  • 用户明确要求的任何内容——YAGNI 约束的是推测性范围,绝不是被请求的范围

一个可运行检查 没有检查的偷懒代码是未完成的:每个非平凡改动都要留下一个可运行检查——逻辑一旦破坏就会失败的最小东西(基于断言的自我检查或一个小的测试文件;不用框架、不用夹具)。平凡的一行代码不需要。

标记刻意简化 当某一层级刻意跳过某些真实内容时,留下 yagni: 注释,写明限制和升级路径——这样捷径读起来是一个决定而不是疏忽,评审时也不会被反复争论。(上游将这些标记为 ponytail:,本技能中随技能改名。)

示例 需求:“加一个日期选择器。”过度构建:安装 flatpickr、写包装组件、加样式表、讨论时区。最小做法:<input type="date">。 需求:“给这个列表去重。”过度构建:带策略接口的 Deduplicator 类。最小做法:[...new Set(items)]。 Bug:三个调用方在 null 上崩溃。过度构建:给每个调用方加 null 防护。最小做法:修一次共享函数。

同类技能 architecture-rescue——事后视角:找出过度构建已经对代码库造成的影响(删除测试)。yagni-gate 是前置反射,避免这类清理成为必要。 plan-intake 的过度构建(YAGNI)环节——同一视角应用于工作项;yagni-gate 将其应用于代码。 caveman——同一纪律应用于响应 token。

触发测试 必须触发:“yagni mode”“stop over-building this”“keep it minimal — YAGNI”。 不应触发:“improve architecture”(属于 architecture-rescue)、“be terse”(属于 caveman)。