docs: 完成任务 #6 归档

ila
2026-08-08 10:16:47 +08:00
parent e5c0f14637
commit 42be5a8acf
@@ -1,9 +1,9 @@
# 6 优化ClaudeCode规则入口 # 6 优化 Claude Code 规则入口
- 类型:需求 / 缺陷 / 重构 - 类型:重构
- 所属 Epic:# - 所属 Epic:无
- 所属 MVP / 版本:# - 所属 MVP / 版本:无
- 状态:待验收 / 已完成 - 状态:待验收
- 日期:2026-08-08 - 日期:2026-08-08
- Gitea 工单:http://ilaer.eicp.net:8418/opc/dev_harness/issues/6 - Gitea 工单:http://ilaer.eicp.net:8418/opc/dev_harness/issues/6
- Wiki 页面:Task-6-优化ClaudeCode规则入口 - 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 工单,避免归档自引用。