diff --git a/Task-6-%E4%BC%98%E5%8C%96ClaudeCode%E8%A7%84%E5%88%99%E5%85%A5%E5%8F%A3.-.md b/Task-6-%E4%BC%98%E5%8C%96ClaudeCode%E8%A7%84%E5%88%99%E5%85%A5%E5%8F%A3.-.md index ba705c8..966010e 100644 --- a/Task-6-%E4%BC%98%E5%8C%96ClaudeCode%E8%A7%84%E5%88%99%E5%85%A5%E5%8F%A3.-.md +++ b/Task-6-%E4%BC%98%E5%8C%96ClaudeCode%E8%A7%84%E5%88%99%E5%85%A5%E5%8F%A3.-.md @@ -1,9 +1,9 @@ -# 6 优化ClaudeCode规则入口 +# 6 优化 Claude Code 规则入口 -- 类型:需求 / 缺陷 / 重构 -- 所属 Epic:# -- 所属 MVP / 版本:# -- 状态:待验收 / 已完成 +- 类型:重构 +- 所属 Epic:无 +- 所属 MVP / 版本:无 +- 状态:待验收 - 日期:2026-08-08 - Gitea 工单:http://ilaer.eicp.net:8418/opc/dev_harness/issues/6 - Wiki 页面:Task-6-优化ClaudeCode规则入口 @@ -11,32 +11,58 @@ ## 背景与目标 - +仓库原有 `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 工单,避免归档自引用。