2026-06-22 21:44:11 +08:00
|
|
|
# CLAUDE.md
|
|
|
|
|
|
|
|
|
|
> Claude Code 的仓库级上下文。进入本仓库后，先读本文，再读 `AGENTS.md` 和 `docs/00-ai-start-here.md`。
|
|
|
|
|
|
|
|
|
|
## 仓库用途
|
|
|
|
|
|
|
|
|
|
这是 harness coding 文档样本库，目标是提供一套新项目启动前可复制的 AI coding 文档模板。
|
|
|
|
|
|
|
|
|
|
这套模板参考了 `D:\opc_project\lingo\docs` 的真实项目文档结构，但本仓库产物应保持通用，不绑定 lingo 的业务、数据、技术栈或任务状态。
|
|
|
|
|
|
2026-06-22 22:26:57 +08:00
|
|
|
## 文档位置
|
|
|
|
|
|
|
|
|
|
harness coding 需要的项目文档模板集中在 `docs/` 目录。
|
|
|
|
|
|
|
|
|
|
后续 Claude Code 进入使用这些模板的新项目时，应先读取仓库级规则文件，再从 `docs/00-ai-start-here.md` 开始建立上下文；该文件会继续导航到需求、技术栈、架构、编码规则、任务看板和当前状态。
|
|
|
|
|
|
|
|
|
|
根目录 `README.md` 和 `docs/README.md` 主要用于人类快速了解样本库和文档清单；Claude Code 真正开始编程时，以 `docs/00-ai-start-here.md` 作为工作入口。
|
|
|
|
|
|
2026-06-22 21:44:11 +08:00
|
|
|
## 关键事实
|
|
|
|
|
|
|
|
|
|
- 根目录 `README.md` 是样本库总入口。
|
|
|
|
|
- `docs/README.md` 是模板文档导航。
|
|
|
|
|
- `docs/00-ai-start-here.md` 是新项目中 AI agent 的工作入口模板。
|
|
|
|
|
- `docs/05-coding-rules.md` 是新项目中 AI agent 的硬约束模板。
|
|
|
|
|
- `docs/06-tasks.md` 是任务看板模板，强调每轮只做一个任务。
|
|
|
|
|
- `docs/current-state.md` 用来记录代码现实，防止文档计划和实际状态脱节。
|
|
|
|
|
|
|
|
|
|
## Claude 工作方式
|
|
|
|
|
|
|
|
|
|
处理本仓库任务时：
|
|
|
|
|
|
|
|
|
|
1. 先确认用户是在要求修改模板本身，还是要求基于模板生成某个具体项目的文档。
|
|
|
|
|
2. 如果是修改模板，保持通用占位符和可复制性。
|
|
|
|
|
3. 如果是生成具体项目文档，允许替换占位符为该项目事实，但不要污染通用样本，除非用户明确要求覆盖模板。
|
|
|
|
|
4. 修改文件前先读相关模板，保持同一套命名和结构。
|
|
|
|
|
5. 修改后检查文档导航是否仍完整。
|
|
|
|
|
|
|
|
|
|
## 不要做
|
|
|
|
|
|
|
|
|
|
- 不要把真实密钥、token、账号、私有 URL 写入模板。
|
|
|
|
|
- 不要把旧项目的具体事实写成新项目通用规则。
|
|
|
|
|
- 不要把模板改成只适合某一种技术栈，除非用户明确要求。
|
|
|
|
|
- 不要在没有用户要求时创建应用代码、依赖配置或构建脚本。
|
|
|
|
|
|
|
|
|
|
## 常用检查命令
|
|
|
|
|
|
|
|
|
|
```powershell
|
|
|
|
|
Get-ChildItem -Recurse -File
|
|
|
|
|
rg -n "AGENTS.md|CLAUDE.md|00-ai-start-here|05-coding-rules|06-tasks" .
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
如果 `rg` 不可用，使用 PowerShell `Select-String`。
|
