AI编程速查手册

CLAUDE.md 编写规范#

Claude Code 的项目级指令文件，放项目根目录，会话启动时自动读取。本质是”给 AI 看的项目交接文档”。 参考：Anthropic 官方文档

1
# 项目名称 — 一句话定位
2
├── 项目概述        ← 做什么、解决什么
3
├── 技术栈          ← 语言/框架/版本/约束
4
├── 项目结构        ← 目录树 + 关键目录职责
5
├── 编码规范        ← 风格/命名/提交/禁止事项
6
├── 构建与运行      ← install/dev/build/test 命令
7
├── 当前进度        ← Checkbox 三档
8
├── 注意事项        ← 踩坑（现象→原因→解法）+ 特殊约定
9
└── 测试说明        ← 跑测试方式、覆盖率要求

1
# 项目名 — 一句话定位
2

3
# 项目概述
4
做什么 + 核心特性（2~3 句）
5

6
# 技术栈
7
| 类别 | 技术 | 版本 | 备注 |
8

9
# 项目结构
10
├── src/ ...  # 职责
11
└── package.json
12

13
# 编码规范
14
- 风格：缩进2空格 / 单引号 / 无分号
15
- 命名：文件PascalCase / 变量camelCase / 常量UPPER_SNAKE
16
- 禁止：❌ any / ❌ 内联样式
17

18
# 构建与运行
19
pnpm install / pnpm dev / pnpm build / pnpm test
20

21
# 当前进度
22
- [x] ... [ ] ... [ ] ...
23

24
# 注意事项
25
- 踩坑：现象→原因→解法
26
- 约定：特殊规则

LLM LOOP#

AGENT 的工作原理：Claude Code 的工作方式:你下达一个目标→cc 自己拆解步骤→自己调用工具→看结果→决定下一步→再调用工具→ 一直循环到任务完成。主动权交给了 AI。这个不断“思考-行动-观察-再思考”的循环,就叫 LLM Loop。

Harness#

CLAUDE.MD—HOOKS—SKILLS—PLUGINS—LSP—MCP—SUBAGENTS

三层记忆#

Claude.md—Auto Memory—SPEC/PLAN/API/PROCESS.md（项目约定规范） .cluadeignore

1
/node_modules
2
.env
3
dist/
4
*.log
5
.next/

速查陌生命令#

1
！npm run dev #（bash）
2
/btw （不污染上下文的提无关问题）
3
/resume 历史会话回复
4
/init
5
/cost
6
/status 查看模型/状态等
7
/simplify 优化
8
/remind 撤回

工作流 workflow#

周期：explore—plan—implement-(review)-commit