3

Task-6-优化ClaudeCode规则入口

ila edited this page 2026-08-08 11:25:37 +08:00

Table of Contents

• 6 优化 Claude Code 规则入口
• 背景与目标
• 最终方案
• 修改文件
• 验收结果
• 测试
• 相关提交

6 优化 Claude Code 规则入口

• 类型：重构
• 所属 Epic：无
• 所属 MVP / 版本：无
• 状态：已完成
• 日期：2026-08-08
• Gitea 工单：#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 明确验收通过。

验收标准	结果
根目录文件名为 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 工单，避免归档自引用。