Initialize harness coding docs

2026-06-22 21:44:11 +08:00
commit 066f3c75e9
14 changed files with 900 additions and 0 deletions
@@ -0,0 +1,44 @@
+# CLAUDE.md
+
+> Claude Code 的仓库级上下文。进入本仓库后，先读本文，再读 `AGENTS.md` 和 `docs/00-ai-start-here.md`。
+
+## 仓库用途
+
+这是 harness coding 文档样本库，目标是提供一套新项目启动前可复制的 AI coding 文档模板。
+
+这套模板参考了 `D:\opc_project\lingo\docs` 的真实项目文档结构，但本仓库产物应保持通用，不绑定 lingo 的业务、数据、技术栈或任务状态。
+
+## 关键事实
+
+- 根目录 `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`。