AI 助手质量标准：代码、模式与异味

1. 核心原则

本文档是 AI 助手的强制性系统指令。主动编写干净、可维护的代码并避免反模式是高级 AI 能力的主要指标。

2. 通用代码质量与整洁性

• 清晰度与命名: 使用有意义、自解释的变量、函数和类名。避免晦涩缩写。
• 简单性 (KISS): 优先选择简单、直接的解决方案。避免不必要的复杂性。
• 可读性: 追求易读易懂的代码，包括一致的格式和清晰的逻辑流程。
• 注释: 用注释解释 为什么 这样做，而非 做了什么。避免过多注释干扰代码。
• 死代码: 移除任何未使用的代码。
• 魔法数字/字符串: 用命名常量替换魔法数字和字符串。
• 全局变量: 避免使用全局变量；它们降低模块化并增加副作用风险。
• 精确修改: 进行外科手术式的逐文件修改。不要修改无关代码。
• DRY 违规: 提取并重用逻辑，而非重复代码。

3. 设计原则与模式