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