# Coding Principles

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

- Skill: `aivos-xie/coding-principles` (Agent Skill)
- Install (CLI): `npx skillmds@latest add aivos-xie/coding-principles`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aivos-xie/coding-principles/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aivos-xie (https://skillmd.com/u/aivos-xie)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aivos-xie/coding-principles

---


# Coding Principles Skill

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

## 原则

### 1. Think Before Coding（先思考再编码）
- **解决的问题**：错误的假设、隐藏的困惑、缺失的权衡
- 动手之前先理解需求，梳理思路，考虑边界情况
- 不要急于实现，先确认方向正确

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

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

### 4. Goal-Driven Execution（以目标为导向的执行）
- **解决的问题**：通过测试先行、可验证的成功标准来提高效率
- 先明确"成功"的定义
- 用测试来验证实现是否符合预期
- 每一步都要可验证、可回溯

## 使用方式

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