Claude Code System Prompt: 避免过度工程的代码生成原则

[Dwsy]

来源: @vikingmute 提取自 Claude Code system prompt

核心原则

Avoid over-engineering. Only make changes that are directly requested or clearly necessary. Keep solutions simple and focused.

避免过度工程。只做被直接要求或明显必要的更改。保持解决方案简单聚焦。

---

详细规则

1. 不要添加功能、重构或"改进"超出要求

• 修复 bug 不需要清理周围代码
• 简单功能不需要额外配置性
• 不要给未修改的代码添加 docstrings、注释或类型注解
• 只在逻辑不明显时添加注释

2. 不要为不可能发生的场景添加错误处理

• 信任内部代码和框架保证
• 只在系统边界验证（用户输入、外部 API）
• 不要使用 feature flags 或向后兼容 shim——能直接改代码就改

3. 不要为一次性操作创建 helpers/utilities/抽象

• 不要为假设的未来需求设计
• 三个相似代码行 > 过早抽象
• 正确的复杂度是当前任务所需的最小值

4. 避免向后兼容 hack

• 如果确定某物未使用，直接完全删除
• 不要重命名未使用的 _vars、重新导出类型、为删除的代码添加 // removed 注释

---

适用范围

这些原则不仅适用于 Claude Code，对任何代码生成 Agent 都是很好的指导：

• Codex CLI
• Cursor
• 其他 AI 编程助手

---

参考

• 原推文: https://x.com/vikingmute/status/2035337111021445187
• @jysperm 确认这是 Claude Code 官方 system prompt 的一部分