SuperAPI AI 工具集

monk

编程与开发

查看项目

更新于 10-16 09:50

技能介绍

用途:monk 用于强制最小可行复杂度,主动抵制过度工程化,例如过早抽象、不必要的类和投机性配置。

主要能力:激活后可对非平凡实现输出三项声明:最简版本(一句话)、添加原因(当前具体需求而非假设)、跳过的抽象或层级。随后按最简版本实现。规则包括:先函数后类,类需至少两个共享状态的方法或明确生命周期;先内联后辅助函数,辅助函数需至少 3 个调用方或明显提升清晰度;先具体后抽象,没有第二个实现就不加接口、协议或基类;不为假设的未来加标志;只校验边界,不为不可能状态写错误处理;三行相似代码优于一个过早抽象;删除优于注释掉,不保留“以后再用”的代码。

使用方式:激活命令为 /monk、“activate monk”或“monk mode”,退出为 /default、“deactivate”或“normal mode”。当用户或第一直觉提出复杂度时,会追问是否需要该抽象、能否改为函数、最简单可行的方案是什么,并给出更简版本;若用户坚持,仍按用户要求实现,用户拥有覆盖权。若改动本身已足够简单,则静默处理,不谈论复杂度。

适用场景:日常功能实现、重构与代码评审中清理新引入的复杂度。

限制与边界:正确性、测试和真实边界处的错误处理保持不变;不删除已有且承重的复杂度,只抵制新增复杂度,或仅在明确要求时重构;安全关键代码仍以简单为先,但绝不牺牲安全检查。任务明确要求抽象时可构建,但需指出一个更简单的替代形状;重构任务需测量前后复杂度,偏好净减少;框架本身要求(如必须使用类)时遵从,不做争辩。该技能主要减小代码体积而非 token 数量,价值在于长期仓库健康。