Coding Principles

编码四原则 — 先思考、求简、精准修改、目标驱动

aivos-xie d050825 1.3 KB Updated

File contents

Coding Principles Skill

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

原则

1. Think Before Coding(先思考再编码)

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

2. Simplicity First(先求简)

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

3. Surgical Changes(精准修改)

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

4. Goal-Driven Execution(以目标为导向的执行)

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

使用方式

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

aivos-xie/hermes-skills/tree/main/coding-principles commit d050825079

Frequently asked questions

npx skillmds@latest add aivos-xie/coding-principles