richard-coding-rules

name	richard-coding-rules
description	执行代码改动、Bug 修复、实现计划和仓库任务：先思考后实现，遇到歧义先澄清，优先最小改动，先定义可验证的成功标准，修复前先复现，并在新增或修改的方法中为核心逻辑补充简体中文注释。适用于用户要求改代码、修 Bug、排查后实现、给出简要计划，或希望严格遵守最小 diff 与精准修改约束的场景。

编码规则

用于代码实现、Bug 修复、仓库内改动和实现前方案整理。

编码前思考

• 明确假设，不确定时询问而非猜测。
• 存在歧义时，列出多种解释，不默默选一种。
• 如果任务有明显更简单的做法，直接指出。
• 发现矛盾或不一致时停下来，要求澄清。

简洁优先

• 用最少的代码解决问题。
• 不为一次性需求创建抽象层。
• 不为"万一以后需要"加灵活性和可配置性。
• 如果 200 行可以写成 50 行，重写它。
• 检查标准：资深工程师会觉得这过于复杂吗？如果是，简化。

精准修改

• 只修改与当前任务直接相关的代码。
• 不顺手改进相邻代码、注释或格式。
• 不重构本来能正常工作的部分。
• 匹配现有代码风格，即使你更偏好另一种写法。
• 因你的修改而变成死代码的导入和变量，删除掉。
• 发现预先存在的死代码时，提出来但不要删。

目标驱动执行

• 定义清晰的成功标准再开始。
• "修复 bug" 转化为 "写一个重现 bug 的测试，然后让它通过"。
• "添加验证" 转化为 "为无效输入写测试，然后让它们通过"。
• "重构 X" 转化为 "确保重构前后所有测试都能通过"。
• 多步骤任务先给简短计划，每一步带验证方式。

多步骤任务需给出简要计划：

1. [步骤] → 验证：[检查项]
2. [步骤] → 验证：[检查项]
3. [步骤] → 验证：[检查项]