From c6f353cbbb81653fe91807689689a8321e6a4ecb Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Sat, 8 Aug 2026 10:18:09 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/task/6-优化ClaudeCode规则入口.md | 76 +++++++++++++++++++++++++++ wiki-docs.json | 4 ++ 2 files changed, 80 insertions(+) create mode 100644 docs/task/6-优化ClaudeCode规则入口.md diff --git a/docs/task/6-优化ClaudeCode规则入口.md b/docs/task/6-优化ClaudeCode规则入口.md new file mode 100644 index 0000000..39616d1 --- /dev/null +++ b/docs/task/6-优化ClaudeCode规则入口.md @@ -0,0 +1,76 @@ + +generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) +wiki_page: Task-6-优化ClaudeCode规则入口 +wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-6-%E4%BC%98%E5%8C%96ClaudeCode%E8%A7%84%E5%88%99%E5%85%A5%E5%8F%A3.- +wiki_revision: 42be5a8acfb2e31f57efbb2d0809b89f3a7c0665 +synchronized_at: 2026-08-08T02:17:30Z + + +# 6 优化 Claude Code 规则入口 + +- 类型：重构 +- 所属 Epic：无 +- 所属 MVP / 版本：无 +- 状态：待验收 +- 日期：2026-08-08 +- Gitea 工单：http://ilaer.eicp.net:8418/opc/dev_harness/issues/6 +- Wiki 页面：Task-6-优化ClaudeCode规则入口 +- Wiki revision：见本地镜像头 + +## 背景与目标 + +仓库原有 `CLAUDE.md` 已声明 `AGENTS.md` 是共同规则来源，但仍手工复制了阅读顺序、安全、工单、Wiki、Git 和验收等多条共同规则。两处同时维护容易产生内容漂移。 + +本任务把 `CLAUDE.md` 优化为 Claude Code 的轻量入口：使用官方支持的 `@AGENTS.md` 语法直接导入共同规则，仅在本文件记录 Claude Code 专用差异。 + +## 最终方案 + +- 在根目录 `CLAUDE.md` 中使用独立的 `@AGENTS.md` 导入行。 +- 删除原先重复的共同流程清单，仅保留三条入口说明。 +- 明确 `AGENTS.md` 是共同规则事实来源，共同规则只在其中维护。 +- 当前没有 Claude Code 特有的项目规则；以后只有平台或工具差异才写入 `CLAUDE.md`。 +- 将 `CLAUDE.md` 加入 Harness 必需文件。 +- 新增入口检查，要求精确的独立导入行和事实来源说明。 +- 新增自动化测试，覆盖正常入口和缺失导入两种情况。 +- 稳定流程语义未变化，因此没有修改稳定 Wiki 主题页。 + +实施结果与建单方案一致。 + +## 修改文件 + +- `CLAUDE.md`：改为导入式 Claude Code 入口，删除重复共同规则。 +- `dev_scripts/check_harness.py`：增加必需文件和 Claude Code 入口检查。 +- `tests/test_harness_docs.py`：增加入口正向测试和缺失导入失败测试。 +- `wiki-docs.json`：登记本任务 Wiki 归档镜像。 +- `docs/task/6-优化ClaudeCode规则入口.md`：本页的自动导出镜像。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 根目录文件名为 `CLAUDE.md` | 通过 | +| 使用 `@AGENTS.md` 导入共同规则 | 通过 | +| 不再复制大段共同流程 | 通过，由 24 行精简为 9 行 | +| 共同规则只维护在 `AGENTS.md` | 通过 | +| Harness 检测缺失入口或导入 | 通过 | +| 测试、严格检查和 Wiki 镜像检查 | 通过 | +| 实现和归档提交分离 | 通过 | + +## 测试 + +- 执行命令：`python -m unittest discover -s tests -v` +- 结果：19/19 通过。 +- 执行命令：`python dev_scripts/check_harness.py --strict` +- 结果：通过。 +- 执行命令：`python dev_scripts/sync_wiki_docs.py --check` +- 结果：归档前 15/15 映射一致；归档后将重新检查 16/16。 +- 执行命令：`python -m compileall -q dev_scripts tests` +- 结果：通过。 +- 执行命令：`git diff --check` +- 结果：通过。 +- **未验证部分**：未启动 Claude Code 交互会话执行 `/memory`；导入语法依据 Claude Code 官方文档，并由仓库检查保证格式。 + +## 相关提交 + +- `2adb30a` `refactor: 优化 Claude Code 规则入口 (#6)` +- 归档提交哈希在提交后回写 Gitea 工单，避免归档自引用。 diff --git a/wiki-docs.json b/wiki-docs.json index 152d3e6..9699d74 100644 --- a/wiki-docs.json +++ b/wiki-docs.json @@ -63,6 +63,10 @@ { "page": "Task-5-Simplify-Agents", "path": "docs/task/5-精简AGENTS重复说明.md" + }, + { + "page": "Task-6-优化ClaudeCode规则入口", + "path": "docs/task/6-优化ClaudeCode规则入口.md" } ] }