如何规范地使用 Claude Code 开发工程
背景
本文总结我自己的 Claude Code 工程开发规范,核心观点:模版化的文件架构 + 标准化的开发流程 = 高质量的工程。
一、核心原则
1. Rules 是基础,Hooks 是保障
| 组件 | 作用 | 性质 |
|---|---|---|
| Rules | 定义工作标准和规范 | 指导性 |
| Hooks | 自动化执行和检查 | 强制性 |
两者配合:Rules 告诉 Claude “应该怎么做”,Hooks 确保"真的做到了"。
2. 每个工程都应该有 CLAUDE.md
CLAUDE.md 是项目的"说明书",包含:
- 项目用途和结构
- 技术栈说明
- 目录组织方式
- 注意事项和坑点
- 当前状态 / 未完成的事
- 相关文档链接
3. 标准化的工作流程
需求 → 规划 → 执行 → 审查 → 提交
二、工程目录结构规范
通用项目模板
项目名称/
├── .claude/
│ ├── rules/ # 规则文件
│ └── agents/ # Agent 配置
├── docs/ # 文档目录
├── src/ # 源代码
├── tests/ # 测试文件
├── CLAUDE.md # 项目说明
└── README.md # 入口文档
Hugo 博客项目模板
博客名称/
├── .claude/ # Claude Code 配置
├── content/ # 文章内容
│ ├── posts/
│ ├── about/
│ └── archive/
├── layouts/ # 模板文件
├── static/ # 静态资源
├── docs/ # 发布目录
├── config.yaml
└── CLAUDE.md
三、开发流程规范
阶段 1:项目初始化
1. 创建项目目录结构
2. 初始化 .claude/ 和 CLAUDE.md
3. 从 ~/.claude/rules/ 中获取 common rules 作为基础
4. 根据工程需要添加其他专用 rules
5. 创建 README.md
6. 初始化 Git 仓库
必须包含的基础 Rules(来自 ~/.claude/rules/):
阅读全文