wangjia/maestro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 登记三类优化方案 HTML（含实现状态表）+ CLAUDE.md 模型档位更新

Browse Source 
- docs/optimization-plan.html：纳入 worktree，顶部新增「★ 实现状态」章节
  （优化点→实现→提交对照，2026-06-25 全部上线，含 3 个线上实测 bug 修复）
- docs/index.html：登记 optimization-plan.html 到「设计方案」分类
- CLAUDE.md：模型档位表改为「按项目可配置 + 默认 opus-4.8」的解析优先级说明，
  回退链改 opus→sonnet→fable，注明 fable-5 不再是内置默认

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
wangjia
2026-06-25 07:08:19 +08:00
parent 59ce391ecc
commit e8fb2bc664
3 changed files with 987 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+13 -7
View File
@@ -77,14 +77,20 @@ score = P(self) + Σ P(completed deps) + Σ P(tasks blocked by self)
### Model Tier Assignment
| Role | Easy | Medium | Hard |
|---|---|---|---|
| executor | claude-sonnet-4-6 | claude-opus-4-8 | claude-opus-4-8 |
| planner | claude-sonnet-4-6 | claude-opus-4-8 | claude-fable-5 |
| reviewer | claude-fable-5 | claude-fable-5 | claude-fable-5 |
| conflict | claude-fable-5 | claude-fable-5 | claude-fable-5 |
Built-in default for **every role × every complexity** is `claude-opus-4-8` (`DEFAULT_MODEL` in `src/executor/models.ts`). Models are **configurable per project** via `projects.models` (JSON).
Reviewer/conflict use the strongest tier (fable-5) and are NOT downgraded by project-level `model` (preserves self-review/conflict-resolution rigor). Project-level `model` overrides executor/planner env vars; env vars override built-in defaults. Model fallback chain on unavailability: `fable-5 → opus-4-8 → sonnet-4-6`.
**Resolution order** (`resolveModel`, highest → lowest):
1. **`project.models[role]`** — per-project per-scenario config. Value is either a model id string (applies to all complexities) or `{easy,medium,hard}` (per-complexity). Applies to **all** roles incl. reviewer/conflict.
2. **legacy `project.model`** — single override, **executor/planner only** (NOT reviewer/conflict, preserving self-review/conflict-resolution independence).
3. **env vars** — `MAESTRO_MODEL_{EASY,MEDIUM,HARD}` (executor), `MAESTRO_MODEL_REVIEW_*` (reviewer), `MAESTRO_MODEL_PLAN_*` (planner).
4. **`DEFAULT_MODEL`** = `claude-opus-4-8`.
Example `projects.models`:
```json
{"executor":{"easy":"claude-sonnet-4-6","hard":"claude-opus-4-8"},"reviewer":"claude-fable-5"}
```
Model fallback chain on unavailability: `opus-4-8 → sonnet-4-6 → fable-5` (`MODEL_FALLBACK_CHAIN`). Note: `claude-fable-5` is no longer a built-in default (it is unavailable in some environments); configure it explicitly per project if desired.
### Data Directory