parallel optimization groundwork

docs/optimization/README.md

@@ -0,0 +1,47 @@
+# ClawGo 并行优化任务拆分
+
+本文档把当前值得优化的方向拆成可并行执行的工作包。每个工作包都有相对独立的文件范围、交付物和验收标准，便于多人或多个 agent 同时推进。
+
+## 工作包总览
+
+| 编号 | 任务 | 主要目标 | 建议并行性 |
+| --- | --- | --- | --- |
+| 01 | 文档与编码清理 | 统一中文文档/示例/输出文本编码，提升可读性 | 可独立执行 |
+| 02 | Gateway 结构拆分 | 拆薄 `cmd/cmd_gateway.go`，降低维护成本 | 可独立执行 |
+| 03 | Provider 层模块化 | 拆分 Provider 协议、OAuth、runtime 状态逻辑 | 可独立执行，但需谨慎 |
+| 04 | 工具注册架构优化 | 抽出工具启动器，清晰区分默认工具、可选工具、子 Agent 可见性 | 可独立执行 |
+| 05 | Gateway API 文档 | 补充 API 认证、接口、请求响应样例 | 可独立执行 |
+| 06 | Cron / Heartbeat / Sentinel 测试 | 补长期运行服务测试覆盖 | 可独立执行 |
+
+## 推荐并行顺序
+
+可以第一批同时启动：
+
+- `01-docs-encoding-cleanup.md`
+- `02-gateway-structure-split.md`
+- `05-gateway-api-docs.md`
+- `06-runtime-service-tests.md`
+
+第二批建议在第一批基本稳定后启动：
+
+- `03-provider-layer-modularization.md`
+- `04-tool-bootstrap-refactor.md`
+
+原因是 Provider 和工具注册都靠近 AgentLoop 核心，改动面更大，最好避开 Gateway 大拆分和文档编码清理的高频改动期。
+
+## 并行开发约定
+
+- 每个任务尽量只改自己文档中列出的主要文件。
+- 如果必须跨任务修改同一文件，先在 PR/提交说明中明确说明原因。
+- 不要顺手重构不在任务范围内的模块。
+- 每个任务完成后至少运行 `go test ./...`，纯文档任务除外。
+- 涉及行为变更时，优先补就近单元测试。
+
+## 任务文件
+
+- [01 文档与编码清理](./01-docs-encoding-cleanup.md)
+- [02 Gateway 结构拆分](./02-gateway-structure-split.md)
+- [03 Provider 层模块化](./03-provider-layer-modularization.md)
+- [04 工具注册架构优化](./04-tool-bootstrap-refactor.md)
+- [05 Gateway API 文档](./05-gateway-api-docs.md)
+- [06 Cron / Heartbeat / Sentinel 测试](./06-runtime-service-tests.md)