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

增加 Claude Code 模型路由规则 #7

New Issue
Closed
opened 2026-08-08 11:16:54 +08:00 by ila · 3 comments
ila commented 2026-08-08 11:16:54 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：开发规则优化
  • 所属 Epic：无
  • 所属 MVP / 版本：无
  • 阶段：已完成

目标

在现有导入式 CLAUDE.md 中增加 Claude Code 专用的模型路由、Agent 交接和 Haiku 只读原则，使 Claude Code 能按任务复杂度选择 Opus、Sonnet 或 Haiku，减少不必要的高成本模型调用和重复上下文。

已确认方案

  • Sonnet 处理目标和范围明确的常规分析、建单与实施。
  • Opus 或 opusplan 处理模糊需求、复杂根因、高风险或架构决策；用户确认方案后交给 Sonnet。
  • Haiku 只处理范围明确的只读检索，不做最终根因、方案、风险或验收判断。
  • 当前模型足够时不升级，也不固定依次调用三个模型。
  • Agent 交接只传递结构化结论、证据和未知项，避免大段重复上下文。
  • Haiku 的只读必须最终由工具权限保证，不能只依赖提示语。

范围

  • CLAUDE.md
  • dev_scripts/check_harness.py
  • Wiki 任务归档、wiki-docs.json 和本地镜像

非目标

  • 不创建 .claude/agents/ 子 Agent 配置。
  • 不修改 Claude Code settings。
  • 不修改 AGENTS.md。
  • 不固定具体模型版本或价格。
  • 不执行多模型基准测试。

验收标准

  • CLAUDE.md 保留 @AGENTS.md 导入和共同规则事实来源说明。
  • 包含模型路由、Agent 交接和 Haiku 只读约束。
  • 明确不要求每个任务依次调用三个模型。
  • 明确 Opus 方案需用户确认后再由 Sonnet 实施。
  • 明确 Haiku 不承担决策且只读应由工具权限实施。
  • 不写死具体模型版本。
  • Harness、测试和 Wiki 镜像检查通过。
  • 实现提交与归档提交分离。

文档影响

  • 不影响稳定 Wiki 主题页，原因：只增加 Claude Code 平台专用路由，不改变共同开发流程。
  • 已先更新 Wiki 任务归档，再导出本地镜像。

未验证部分

未创建或运行 Haiku 只读子 Agent，未执行多模型 Token/耗时基准；这些不在本任务范围内。

## 基本信息 - 类型：开发规则优化 - 所属 Epic：无 - 所属 MVP / 版本：无 - 阶段：已完成 ## 目标 在现有导入式 `CLAUDE.md` 中增加 Claude Code 专用的模型路由、Agent 交接和 Haiku 只读原则，使 Claude Code 能按任务复杂度选择 Opus、Sonnet 或 Haiku，减少不必要的高成本模型调用和重复上下文。 ## 已确认方案 - Sonnet 处理目标和范围明确的常规分析、建单与实施。 - Opus 或 `opusplan` 处理模糊需求、复杂根因、高风险或架构决策；用户确认方案后交给 Sonnet。 - Haiku 只处理范围明确的只读检索，不做最终根因、方案、风险或验收判断。 - 当前模型足够时不升级，也不固定依次调用三个模型。 - Agent 交接只传递结构化结论、证据和未知项，避免大段重复上下文。 - Haiku 的只读必须最终由工具权限保证，不能只依赖提示语。 ## 范围 - `CLAUDE.md` - `dev_scripts/check_harness.py` - Wiki 任务归档、`wiki-docs.json` 和本地镜像 ## 非目标 - 不创建 `.claude/agents/` 子 Agent 配置。 - 不修改 Claude Code settings。 - 不修改 `AGENTS.md`。 - 不固定具体模型版本或价格。 - 不执行多模型基准测试。 ## 验收标准 - [x] `CLAUDE.md` 保留 `@AGENTS.md` 导入和共同规则事实来源说明。 - [x] 包含模型路由、Agent 交接和 Haiku 只读约束。 - [x] 明确不要求每个任务依次调用三个模型。 - [x] 明确 Opus 方案需用户确认后再由 Sonnet 实施。 - [x] 明确 Haiku 不承担决策且只读应由工具权限实施。 - [x] 不写死具体模型版本。 - [x] Harness、测试和 Wiki 镜像检查通过。 - [x] 实现提交与归档提交分离。 ## 文档影响 - [x] 不影响稳定 Wiki 主题页，原因：只增加 Claude Code 平台专用路由，不改变共同开发流程。 - [x] 已先更新 Wiki 任务归档，再导出本地镜像。 ## 未验证部分 未创建或运行 Haiku 只读子 Agent，未执行多模型 Token/耗时基准；这些不在本任务范围内。
ila commented 2026-08-08 11:18:14 +08:00
Author
Owner
Copy Link
Copy Source

实现完成，进入归档阶段

  • CLAUDE.md 新增模型路由、Agent 交接和 Haiku 只读约束。
  • 简单明确任务默认 Sonnet；复杂或高风险方案交给 Opus/opusplan，用户确认后再由 Sonnet 建单实施。
  • Haiku 仅用于范围明确的只读检索，不承担最终根因、方案、风险或验收判断。
  • 明确当前模型足够时不升级，也不固定依次调用三个模型。
  • 由于本任务未创建子 Agent 配置，未配置工具级只读权限时禁止调用 Haiku 处理项目内容。
  • Harness 已增加关键章节和边界语句检查。

实现提交：3bfe752

首轮验证：

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

稳定开发流程语义未变化，不修改稳定 Wiki 主题页；下一步创建任务归档。

## 实现完成，进入归档阶段 - `CLAUDE.md` 新增模型路由、Agent 交接和 Haiku 只读约束。 - 简单明确任务默认 Sonnet；复杂或高风险方案交给 Opus/`opusplan`，用户确认后再由 Sonnet 建单实施。 - Haiku 仅用于范围明确的只读检索，不承担最终根因、方案、风险或验收判断。 - 明确当前模型足够时不升级，也不固定依次调用三个模型。 - 由于本任务未创建子 Agent 配置，未配置工具级只读权限时禁止调用 Haiku 处理项目内容。 - Harness 已增加关键章节和边界语句检查。 实现提交：`3bfe752` 首轮验证： - 单元测试：19/19 通过 - 严格 Harness 检查：通过 - Wiki 镜像：16/16 一致 - Python 编译检查：通过 - `git diff --check`：通过 稳定开发流程语义未变化，不修改稳定 Wiki 主题页；下一步创建任务归档。
ila referenced this issue from a commit 2026-08-08 11:22:18 +08:00
docs: 归档任务 #7
ila commented 2026-08-08 11:22:39 +08:00
Author
Owner
Copy Link
Copy Source

最终实施与归档证据

  • 状态：待验收（未关闭）
  • 实现提交：3bfe752（docs: 增加 Claude Code 模型路由 (#7)）
  • 归档提交：98df3a2（docs: 归档任务 #7）
  • 远端 main：已推送至 98df3a2
  • Wiki 归档：Task-7-ClaudeCode模型路由
  • Wiki 版本：21200c65b99ff5cd5a27cae6116ed8b56f938a28
  • 本地只读镜像：docs/task/7-ClaudeCode模型路由.md

最终验证

  • 单元测试：19/19 通过
  • 严格 Harness 检查：通过
  • Wiki 镜像检查：17/17 一致
  • Python 编译检查：通过
  • git diff --check：通过
  • 工作区：干净
  • 未验证：未创建或运行 Haiku 只读子 Agent，未执行多模型 Token/耗时基准。

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

## 最终实施与归档证据 - 状态：待验收（未关闭） - 实现提交：`3bfe752`（`docs: 增加 Claude Code 模型路由 (#7)`） - 归档提交：`98df3a2`（`docs: 归档任务 #7`） - 远端 `main`：已推送至 `98df3a2` - Wiki 归档：[Task-7-ClaudeCode模型路由](http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-7-ClaudeCode%E6%A8%A1%E5%9E%8B%E8%B7%AF%E7%94%B1.-) - Wiki 版本：`21200c65b99ff5cd5a27cae6116ed8b56f938a28` - 本地只读镜像：`docs/task/7-ClaudeCode模型路由.md` ### 最终验证 - 单元测试：19/19 通过 - 严格 Harness 检查：通过 - Wiki 镜像检查：17/17 一致 - Python 编译检查：通过 - `git diff --check`：通过 - 工作区：干净 - 未验证：未创建或运行 Haiku 只读子 Agent，未执行多模型 Token/耗时基准。 请按验收标准检查；收到明确“#7 验收通过”后再关闭工单。
ila closed this issue 2026-08-08 11:27:50 +08:00
ila commented 2026-08-08 11:28:07 +08:00
Author
Owner
Copy Link
Copy Source

验收完成

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

  • 验收归档提交：d1136c2（已推送至远端 main）
  • Wiki 归档：任务 #7
  • Wiki revision：cfd37f7beab92133e1528104df9553e3e7835aff
  • 本地只读镜像：docs/task/7-ClaudeCode模型路由.md
  • 最终验证：19/19 单元测试通过、Harness 严格检查通过、17/17 Wiki 镜像一致
## 验收完成 用户已明确确认 #7 验收通过，工单已关闭。 - 验收归档提交：`d1136c2`（已推送至远端 `main`） - Wiki 归档：[任务 #7](http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-7-ClaudeCode%E6%A8%A1%E5%9E%8B%E8%B7%AF%E7%94%B1.-) - Wiki revision：`cfd37f7beab92133e1528104df9553e3e7835aff` - 本地只读镜像：`docs/task/7-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#7