SuperAPI AI 工具集

simplicity-principles

编程与开发

查看项目

更新于 10-16 03:13

技能介绍

用途:在设计方案、添加功能或重构时,用三条原则约束编码决策,避免过度设计、投机功能和意外行为。

主要能力:

  1. KISS(保持简单):优先可读、少抽象、直接明显的实现,便于调试与测试;倾向函数而非类、显式而非隐式、常规而非炫技。例外:经性能剖析确认的热点代码、第三次重复时的去重、类型与校验等约束。
  2. YAGNI(你不需要它):只在有具体用例时才实现功能,删除未用代码,从硬编码起步,需要变化时再提取。例外:安全防护、数据迁移、公开 API、无障碍支持宜前置考虑。
  3. POLA(最小惊讶):代码行为应符合使用者预期,命名与行为一致、返回值一致、副作用显式、遵循框架与平台约定。

使用方式:资料未提供独立的安装或调用命令,仅以技能形式给出。可在实现前自问:这是最简方案吗(KISS)?现在真的需要吗(YAGNI)?行为会让人意外吗(POLA)?实现中保持直白、只做所需、遵循约定、准确命名、显式副作用;代码评审时检查是否有更简方案、是否在造投机功能、API 是否如预期、约定是否遵循。资料给出 Elixir 与 TypeScript 的正反例对照,含 GenServer、宏、类封装、可选参数、接口泛型、Button 变体等,可作参照;不要求照抄长示例。

适用场景:日常功能开发、重构、代码评审、API 设计。可与 solid-principles、boy-scout-rule、test-driven-development 及 Elixir/TypeScript 代码质量工具配合。

限制:仅为原则性指导,非强制规则;简单不等于简陋,仍须正确处理错误与边界情况。资料未提供具体收费、平台支持范围或版本要求。