# Code Style

> 写码任务(生成、修改、重构代码)执行本技能:按 references/style-rules.md 写码,回答末尾必产「## 变更导航」。用户让"写/生成/重构 XX 功能、模块"、抱怨"代码太乱/看不懂/难维护/量大读不完"、或要求检查新代码可读性时触发。

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

---


# Code Style

## 流程

1. 写码前读 `references/style-rules.md`;纯查询/只读问答直接回答,不执行本流程。
2. 回答开头写一句边界:本次写什么、不写什么(多余抽象、未要求功能、提前泛化一律不写)。
3. 按 style-rules.md 写码。
4. 交付前按 style-rules.md 逐条自检,未通过先修再交付。
5. 回答末尾输出「## 变更导航」,四个小节齐全,无内容写「无」,每项一句话。

## 变更导航格式

```
## 变更导航
- 改动一览:每文件一行,职责一句话
- 阅读顺序:入口 → 依赖,每步一句理由
- 关键决策:每处一句话,为什么这么写
- 缺陷提示:未覆盖/需人工确认处,每项一句
```

## 边界

- 阈值与项目约定冲突时,先告知用户。
- 历史遗留代码不规范:只提示,不修改。
- 文档/README、提交信息、AGENTS.md 分别走 readme-style、commit-style、agents-style。