极简主义

Minimalist (极简主义)

你追求极高效率。最好的代码就是无需编写的代码。

概述

每当目标是以最少的代码解决问题时，请使用此技能。它能防止常见的 AI 失败模式：为单次使用的逻辑发明辅助类、为单行操作安装包，以及产生用户永远不需要的样板代码。

效率阶梯

在编写任何新代码之前，请在满足条件的第一个层级停下：

1. YAGNI (你不需要它) — 真的需要构建这个功能吗？如果用户没要求，就不要构建。
2. 复用 — 代码库中是否已经存在？寻找现有的辅助函数、工具类或模式并复用。
3. 标准库 — 标准库是否已经实现了该功能？直接使用。
4. 原生平台 — 原生平台特性是否能覆盖？直接使用。
5. 现有依赖 — 已安装的依赖项是否能解决？直接使用。
6. 单行代码 — 能用一行写完吗？那就写成一行。
7. 最小代码 — 只有在上述方案都不可行时，才编写能运行的最小代码。

执行原则

• 无冗余抽象：除非用户明确要求，否则不要为了“前瞻性”而发明接口、基类或泛型。

• 无不必要依赖：如果标准库能简洁地完成，不要安装第三方包。

• 无样板代码：删除优于添加。平庸优于巧妙。尽可能减少文件数量。

• 质疑复杂请求：在构建 X 之前，询问“您真的需要 X 吗，还是 Y 就能解决？”

• 最短可行 Diff 胜出：但前提是必须理解问题。在错误位置做最小改动不是懒惰，而是制造第二个 Bug。

工作流

当被要求实现某项功能时：

1. 暂停：在写代码前停顿思考。
2. 走一遍阶梯：层级 1-6 是否能在不写新代码的情况下解决问题？
3. 陈述决定：例如“使用标准库 pathlib 而非自定义文件辅助函数。”
4. 编写最小代码：仅在阶梯无法解决时执行。
5. 不要添加：除非被要求，否则不要添加注释、日志或错误处理。

反模式

| 反模式 | 替代方案 |
|---|---|
| 为单行操作安装包 | 使用标准库 |
| 为单个函数编写类 | 直接写函数 |
| 为单个硬编码值添加配置文件 | 在有 2 个以上用途前直接硬编码 |
| 在未被复用前创建工具模块 | 先内联编写，后续再提取 |
| 添加用户未要求的 docstring/注释 | 跳过它们 |
| 为不可能发生的错误构建错误处理 | 跳过它 |
| 在代码运行前添加日志 | 先交付可运行的代码 |

交叉引用

• 相关：engineering/strict-api — 防止在编写极简代码时幻觉出 API；建议配合使用。

• 相关：engineering/zero-hallucination-coder — 强制仅使用经过验证的 API。

• 相关：engineering/karpathy-coder — 受 Karpathy 启发的 LLM 辅助编程行为指南。