opc/dev_harness
2
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases Wiki Activity

优化 Claude Code 项目规则入口 #6

New Issue
Closed
opened 2026-08-08 10:13:55 +08:00 by ila · 3 comments
ila commented 2026-08-08 10:13:55 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：重构
  • 所属 Epic：无
  • 所属 MVP / 版本：无
  • 阶段：已完成

目标

优化仓库根目录 CLAUDE.md：让 Claude Code 直接导入并遵守 AGENTS.md，避免复制共同规则造成双份维护，同时保留清晰的 Claude Code 专用入口。

已确认方案

  • 使用 Claude Code 官方支持的 @AGENTS.md 导入语法。
  • AGENTS.md 继续作为所有编码 Agent 的共同规则事实来源。
  • CLAUDE.md 只保留入口说明和 Claude Code 专用差异，不复制工单、Wiki、Git、安全、验收等共同规则。
  • Harness 增加最小结构检查，防止以后删除入口或导入。

非目标

  • 不修改现有业务开发流程。
  • 不修改 Gitea Wiki 的稳定主题页正文；本任务没有产生新的长期流程规则。
  • 不增加 Claude Code 权限、Hook、MCP 或个人配置。
  • 不修改 AGENTS.md 的现有规则。

修改范围

  • CLAUDE.md
  • dev_scripts/check_harness.py
  • tests/test_harness_docs.py
  • Wiki 任务归档、wiki-docs.json 和对应 docs/task 镜像

风险与回退

  • 风险：导入语法写错会导致 Claude Code 未加载共同规则。
  • 控制：自动检查确认根级 CLAUDE.md 包含独立的 @AGENTS.md 导入。
  • 回退：回退本任务实现提交，恢复原入口文件。

验收标准

  • 根目录文件名为 CLAUDE.md。
  • CLAUDE.md 使用 @AGENTS.md 导入共同规则。
  • 不再复制 AGENTS.md 中的大段共同流程。
  • 明确共同规则只维护在 AGENTS.md，本文件仅保存 Claude Code 专用差异。
  • Harness 能检测缺失的 Claude Code 入口或导入。
  • 单元测试、严格 Harness 检查、Wiki 镜像检查全部通过。
  • 实现提交和任务归档提交分离，证据写回工单。

文档影响

  • 不影响稳定 Wiki 主题页，原因：只优化 Claude Code 对现有共同规则的加载方式，流程语义不变。
  • 已先创建并更新 Wiki 任务归档，再导出本地镜像。
## 基本信息 - 类型：重构 - 所属 Epic：无 - 所属 MVP / 版本：无 - 阶段：已完成 ## 目标 优化仓库根目录 `CLAUDE.md`：让 Claude Code 直接导入并遵守 `AGENTS.md`，避免复制共同规则造成双份维护，同时保留清晰的 Claude Code 专用入口。 ## 已确认方案 - 使用 Claude Code 官方支持的 `@AGENTS.md` 导入语法。 - `AGENTS.md` 继续作为所有编码 Agent 的共同规则事实来源。 - `CLAUDE.md` 只保留入口说明和 Claude Code 专用差异，不复制工单、Wiki、Git、安全、验收等共同规则。 - Harness 增加最小结构检查，防止以后删除入口或导入。 ## 非目标 - 不修改现有业务开发流程。 - 不修改 Gitea Wiki 的稳定主题页正文；本任务没有产生新的长期流程规则。 - 不增加 Claude Code 权限、Hook、MCP 或个人配置。 - 不修改 `AGENTS.md` 的现有规则。 ## 修改范围 - `CLAUDE.md` - `dev_scripts/check_harness.py` - `tests/test_harness_docs.py` - Wiki 任务归档、`wiki-docs.json` 和对应 `docs/task` 镜像 ## 风险与回退 - 风险：导入语法写错会导致 Claude Code 未加载共同规则。 - 控制：自动检查确认根级 `CLAUDE.md` 包含独立的 `@AGENTS.md` 导入。 - 回退：回退本任务实现提交，恢复原入口文件。 ## 验收标准 - [x] 根目录文件名为 `CLAUDE.md`。 - [x] `CLAUDE.md` 使用 `@AGENTS.md` 导入共同规则。 - [x] 不再复制 `AGENTS.md` 中的大段共同流程。 - [x] 明确共同规则只维护在 `AGENTS.md`，本文件仅保存 Claude Code 专用差异。 - [x] Harness 能检测缺失的 Claude Code 入口或导入。 - [x] 单元测试、严格 Harness 检查、Wiki 镜像检查全部通过。 - [x] 实现提交和任务归档提交分离，证据写回工单。 ## 文档影响 - [x] 不影响稳定 Wiki 主题页，原因：只优化 Claude Code 对现有共同规则的加载方式，流程语义不变。 - [x] 已先创建并更新 Wiki 任务归档，再导出本地镜像。
ila commented 2026-08-08 10:15:32 +08:00
Author
Owner
Copy Link
Copy Source

实现完成，进入归档阶段

  • CLAUDE.md 已由手工重复规则改为独立的 @AGENTS.md 导入。
  • 文件仅保留 Claude Code 专用入口说明；共同规则继续只维护在 AGENTS.md。
  • Harness 已把 CLAUDE.md 列为必需文件，并检查精确导入行和事实来源说明。
  • 新增正向检查和缺失导入的失败用例。

实现提交：2adb30a

首轮验证：

  • 单元测试：19/19 通过
  • 严格 Harness 检查：通过
  • Wiki 镜像：15/15 一致
  • Python 编译检查：通过
  • git diff --check：通过

稳定 Wiki 流程语义没有变化，不修改主题页；下一步创建本任务 Wiki 归档并同步本地镜像。

## 实现完成，进入归档阶段 - `CLAUDE.md` 已由手工重复规则改为独立的 `@AGENTS.md` 导入。 - 文件仅保留 Claude Code 专用入口说明；共同规则继续只维护在 `AGENTS.md`。 - Harness 已把 `CLAUDE.md` 列为必需文件，并检查精确导入行和事实来源说明。 - 新增正向检查和缺失导入的失败用例。 实现提交：`2adb30a` 首轮验证： - 单元测试：19/19 通过 - 严格 Harness 检查：通过 - Wiki 镜像：15/15 一致 - Python 编译检查：通过 - `git diff --check`：通过 稳定 Wiki 流程语义没有变化，不修改主题页；下一步创建本任务 Wiki 归档并同步本地镜像。
ila referenced this issue from a commit 2026-08-08 10:18:55 +08:00
docs: 归档任务 #6
ila commented 2026-08-08 10:19:17 +08:00
Author
Owner
Copy Link
Copy Source

最终实施与归档证据

  • 状态：待验收（未关闭）
  • 实现提交：2adb30a（refactor: 优化 Claude Code 规则入口 (#6)）
  • 归档提交：c6f353c（docs: 归档任务 #6）
  • 远端 main：已推送至 c6f353c
  • Wiki 归档：Task-6-优化ClaudeCode规则入口
  • Wiki 版本：42be5a8acfb2e31f57efbb2d0809b89f3a7c0665
  • 本地只读镜像：docs/task/6-优化ClaudeCode规则入口.md

最终验证

  • 单元测试：19/19 通过
  • 严格 Harness 检查：通过
  • Wiki 镜像检查：16/16 一致
  • Python 编译检查：通过
  • git diff --check：通过
  • 工作区：干净
  • 未验证：未实际启动 Claude Code 交互会话执行 /memory；导入语法依据官方文档，仓库自动检查已覆盖格式。

请按验收标准检查；收到明确“#6 验收通过”后再关闭工单。

## 最终实施与归档证据 - 状态：待验收（未关闭） - 实现提交：`2adb30a`（`refactor: 优化 Claude Code 规则入口 (#6)`） - 归档提交：`c6f353c`（`docs: 归档任务 #6`） - 远端 `main`：已推送至 `c6f353c` - Wiki 归档：[Task-6-优化ClaudeCode规则入口](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 版本：`42be5a8acfb2e31f57efbb2d0809b89f3a7c0665` - 本地只读镜像：`docs/task/6-优化ClaudeCode规则入口.md` ### 最终验证 - 单元测试：19/19 通过 - 严格 Harness 检查：通过 - Wiki 镜像检查：16/16 一致 - Python 编译检查：通过 - `git diff --check`：通过 - 工作区：干净 - 未验证：未实际启动 Claude Code 交互会话执行 `/memory`；导入语法依据官方文档，仓库自动检查已覆盖格式。 请按验收标准检查；收到明确“#6 验收通过”后再关闭工单。
ila closed this issue 2026-08-08 11:27:49 +08:00
ila commented 2026-08-08 11:28:06 +08:00
Author
Owner
Copy Link
Copy Source

验收完成

用户已明确确认 #6 验收通过，工单已关闭。

  • 验收归档提交：d1136c2（已推送至远端 main）
  • Wiki 归档：任务 #6
  • Wiki revision：321e7016b2fcdf39f5bc6453310b233d00e81f07
  • 本地只读镜像：docs/task/6-优化ClaudeCode规则入口.md
  • 最终验证：19/19 单元测试通过、Harness 严格检查通过、17/17 Wiki 镜像一致
## 验收完成 用户已明确确认 #6 验收通过，工单已关闭。 - 验收归档提交：`d1136c2`（已推送至远端 `main`） - Wiki 归档：[任务 #6](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：`321e7016b2fcdf39f5bc6453310b233d00e81f07` - 本地只读镜像：`docs/task/6-优化ClaudeCode规则入口.md` - 最终验证：19/19 单元测试通过、Harness 严格检查通过、17/17 Wiki 镜像一致
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: opc/dev_harness#6