coding-principles

name	coding-principles
description	编码四原则 — 先思考、求简、精准修改、目标驱动
triggers	["coding","programming","code review","debugging","写代码","编程"]

Coding Principles Skill

编码时必须遵循的四条核心原则。

原则

1. Think Before Coding（先思考再编码）

• 解决的问题：错误的假设、隐藏的困惑、缺失的权衡
• 动手之前先理解需求，梳理思路，考虑边界情况
• 不要急于实现，先确认方向正确

2. Simplicity First（先求简）

• 解决的问题：过度复杂化、臃肿的抽象
• 优先选择最简单的实现方案
• 避免过度设计，不要为了"优雅"而增加不必要的复杂度
• 能用 10 行解决的问题不要用 100 行

3. Surgical Changes（精准修改）

• 解决的问题：正交编辑、修改不该触碰的代码
• 只改需要改的部分，不要"顺手"重构不相关的代码
• 每次修改都要有明确的目的
• 最小化变更范围，降低引入新 bug 的风险

4. Goal-Driven Execution（以目标为导向的执行）

• 解决的问题：通过测试先行、可验证的成功标准来提高效率
• 先明确"成功"的定义
• 用测试来验证实现是否符合预期
• 每一步都要可验证、可回溯

使用方式

在编码、调试、代码审查时，参考这四条原则来指导决策。