CLAUDE.md 别从空白写起:三套模板按项目类型选
说明与用途
使用三套按项目类型定制的 CLAUDE.md 模板,帮助团队快速生成 AI 可用的文档,避免占位符残留和通用规范。
问题
新项目在写 CLAUDE.md 时常出现两种废话:抄项目简介或列泛泛的规范,导致 AI 无法使用。
结果
使用三套模板后,团队能快速生成 AI 可执行的 CLAUDE.md,避免占位符残留和不适用段落,提升 AI 交互效率。
工作流
- 选择合适的模板(docs‑site、python‑scripts 或 web‑fullstack)
- 复制对应模板为仓库根目录的 CLAUDE.md
- 按注释修改
<code>标记的项目特有信息 - 删除不适用的段落,保留真实约定
- 清零所有占位符并提交
- 使用工作流包的 10 条中文 slash commands(/plan、/test、/review、/commit、/doc 等)验证 AI 能按文件命令执行
- 根据验证结果修正 CLAUDE.md
证据
三套模板只解决这一件事:按项目类型先选对骨架,再把 `` 占位换成你自己的信息。
占位符必须清零再提交。没改掉就等于没写——AI 会把占位符当成真实信息用,或者直接忽略整段。
- 记录日期: 2026-11-04T01:14:05.122Z