diff --git a/Task-7-ClaudeCode%E6%A8%A1%E5%9E%8B%E8%B7%AF%E7%94%B1.-.md b/Task-7-ClaudeCode%E6%A8%A1%E5%9E%8B%E8%B7%AF%E7%94%B1.-.md index 7a01fe9..5c37180 100644 --- a/Task-7-ClaudeCode%E6%A8%A1%E5%9E%8B%E8%B7%AF%E7%94%B1.-.md +++ b/Task-7-ClaudeCode%E6%A8%A1%E5%9E%8B%E8%B7%AF%E7%94%B1.-.md @@ -1,9 +1,9 @@ -# 7 ClaudeCode模型路由 +# 7 Claude Code 模型路由 -- 类型:需求 / 缺陷 / 重构 -- 所属 Epic:# -- 所属 MVP / 版本:# -- 状态:待验收 / 已完成 +- 类型:开发规则优化 +- 所属 Epic:无 +- 所属 MVP / 版本:无 +- 状态:待验收 - 日期:2026-08-08 - Gitea 工单:http://ilaer.eicp.net:8418/opc/dev_harness/issues/7 - Wiki 页面:Task-7-ClaudeCode模型路由 @@ -11,32 +11,61 @@ ## 背景与目标 - +Claude Code 已通过 `CLAUDE.md` 导入共同开发规则,但没有说明 Opus、Sonnet 和 Haiku 应如何按任务复杂度分工。若每个任务固定依次调用三个模型,会增加重复上下文、Token 和等待时间;如果只用提示语要求 Haiku 只读,又不能真正限制其工具权限。 + +本任务在 Claude Code 专用入口中增加按需模型路由、结构化交接和 Haiku 只读边界。 ## 最终方案 - +- 目标、范围和修改位置明确的任务默认由 Sonnet 分析、建单和实施。 +- 模糊需求、复杂根因、跨模块架构或高风险任务由 Opus/`opusplan` 制定方案。 +- Opus 方案必须先由用户确认,再交给 Sonnet 创建工单和实施。 +- Haiku 仅用于范围明确的文档、代码入口、日志事实和调用关系检索。 +- Haiku 不承担最终根因、技术方案、风险等级和验收结论。 +- 当前模型足够时不升级,不固定依次调用三个模型。 +- Agent 只交接结构化事实、假设、范围、风险、证据位置和未知项,减少大段重复上下文。 +- Haiku 只读必须由工具权限实现;本任务未创建子 Agent 配置,因此未配置只读权限时不得调用 Haiku 处理项目内容。 +- Harness 检查三个新增章节及关键边界,防止后续误删。 +- 未写死具体模型版本,继续使用模型别名。 + +实施结果与已确认方案一致。 ## 修改文件 -- `<文件>`:<改动说明> +- `CLAUDE.md`:增加模型路由、Agent 交接和 Haiku 只读约束。 +- `dev_scripts/check_harness.py`:增加 Claude Code 路由规则的结构检查。 +- `wiki-docs.json`:登记本任务 Wiki 归档镜像。 +- `docs/task/7-ClaudeCode模型路由.md`:本页的自动导出镜像。 ## 验收结果 | 验收标准 | 结果 | |---|---| -| | 通过 / 未通过 | +| 保留 `@AGENTS.md` 导入和共同规则来源说明 | 通过 | +| 包含模型路由、Agent 交接和 Haiku 只读约束 | 通过 | +| 不要求每个任务依次调用三个模型 | 通过 | +| Opus 方案经用户确认后由 Sonnet 实施 | 通过 | +| Haiku 不做最终决策 | 通过 | +| Haiku 只读要求工具权限实施 | 通过 | +| 不写死具体模型版本 | 通过 | +| Harness、测试和镜像检查 | 通过 | +| 实现和归档提交分离 | 通过 | ## 测试 -- 执行命令:`<命令>` -- 结果: -- **未验证部分**: - -## 遗留问题 - - +- 执行命令:`python -m unittest discover -s tests -v` +- 结果:19/19 通过。 +- 执行命令:`python dev_scripts/check_harness.py --strict` +- 结果:通过。 +- 执行命令:`python dev_scripts/sync_wiki_docs.py --check` +- 结果:归档前 16/16 映射一致;归档后重新检查 17/17。 +- 执行命令:`python -m compileall -q dev_scripts tests` +- 结果:通过。 +- 执行命令:`git diff --check` +- 结果:通过。 +- **未验证部分**:未创建或运行 Haiku 只读子 Agent,未执行多模型 Token/耗时基准;这些均不在本任务范围内。 ## 相关提交 -- `<提交哈希>` <提交说明> +- `3bfe752` `docs: 增加 Claude Code 模型路由 (#7)` +- 归档提交哈希在提交后回写 Gitea 工单,避免归档自引用。