2026-08-08 10:18:09 +08:00
|
|
|
<!-- gitea-wiki-mirror:start -->
|
|
|
|
|
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.-
|
2026-08-08 11:27:19 +08:00
|
|
|
wiki_revision: 321e7016b2fcdf39f5bc6453310b233d00e81f07
|
|
|
|
|
synchronized_at: 2026-08-08T03:26:20Z
|
2026-08-08 10:18:09 +08:00
|
|
|
<!-- gitea-wiki-mirror:end -->
|
|
|
|
|
|
|
|
|
|
# 6 优化 Claude Code 规则入口
|
|
|
|
|
|
|
|
|
|
- 类型：重构
|
|
|
|
|
- 所属 Epic：无
|
|
|
|
|
- 所属 MVP / 版本：无
|
2026-08-08 11:27:19 +08:00
|
|
|
- 状态：已完成
|
2026-08-08 10:18:09 +08:00
|
|
|
- 日期：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`：本页的自动导出镜像。
|
|
|
|
|
|
|
|
|
|
## 验收结果
|
|
|
|
|
|
2026-08-08 11:27:19 +08:00
|
|
|
用户于 2026-08-08 明确验收通过。
|
|
|
|
|
|
2026-08-08 10:18:09 +08:00
|
|
|
| 验收标准 | 结果 |
|
|
|
|
|
|---|---|
|
|
|
|
|
| 根目录文件名为 `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 工单，避免归档自引用。
|
