MAESTRO · 文档索引 / docs index

Maestro 项目全部文档的单一入口。按 设计方案 / 实现计划 / 知识库调研 / 排障 Runbook 分类汇总(HTML 与历史 MD 都列)。新增文档须同时登记此处。

设计 设计方案 / 架构设计 · 2
MAESTRO · 架构设计
docs/architecture.html
系统整体架构设计:进程模型(daemon 唯一 DB 写者 / worker 文件协议)、前后端、数据流、调度与执行管道总览。
架构HTML
三类任务执行方法优化方案 · 含实现状态
docs/optimization-plan.html
三类后台 agent(① 拆解 / ② 执行+双复审 / ③ 解冲突)的六维优化定稿 + 通用规则 + 状态机/ER 图 + Agent 记忆注入 L1–L4。顶部 ★ 实现状态表给出每个优化点 → 提交对照(2026-06-25 全部上线,含 3 个线上实测 bug 修复)。含模型按项目可配置(默认 opus-4.8)diff 声明外文件硬闸
优化方案HTML
计划 实现计划 · 2
Maestro 大重构全景 · 现状 → 目标 → 计划
docs/superpowers/plans/2026-06-22-maestro-refactor-phase1.html
扁平 FSM → schedule_status × work_type 正交模型的完整技术蓝图(HTML 阅读版)。四标签:现状架构 / 重构目标 / 设计方案 / 具体实现。专题含:状态设计、任务提交与入口(网页/MCP/todo 同步三入口·图片文件附件·AI 提任务)、并发调度(CAS·couplingPenalty)、交互平面·stuck 人工接管、数据库 Schema(ER 图)、Agent 记忆注入 L1–L4、Agent 规格与注册表(每 agent 流程/模型/skill/prompt/上下文 + 动态扩展)运维与护栏(成本预算治理·限流背压·资源 GC·可观测·依赖环检测)安全与沙箱前端 API 契约(REST 全量 + WS 事件)、Phase 1 逐步实施计划。全部图表为深色内联 SVG(自包含、无 CDN)。
实现计划设计HTML 阅读版
同上 · Markdown 执行真相源
docs/superpowers/plans/2026-06-22-maestro-refactor-phase1.md
上面 HTML 的同源 .md,保留 - [ ] checkbox 供 executing-plans / subagent-driven-development 驱动执行跟踪。.md 是执行真相源,.html 仅供阅读。
执行真相源MD
调研 知识库调研 · 2
用量与成本计算说明 · 数据源口径 + cost 公式 + 时区分桶
docs/usage-cost-explained.html
讲清全局面板「用量」的两个互不相交数据源:① 账号级订阅额度(usage.ts 直连 oauth/usage,含你自己的 Claude Code 交互会话)vs ② maestro 自有 run 的 cost/token(cc.ts→ingest→store,仅任务执行)——这就是「只有 maestro 在跑却有其他 token 消费」的真相。含 cost 公式(四类 token × 各模型单价 / 1e6,引自 pricing.ts 单价表)、按天/周/月分桶规则与本地时区口径(修复 UTC 偏移一天 bug)、$ 为 API 列表价名义估算非订阅实账单、分模型 token 近似与未知模型记 0 两项已知近似。
HTML用量/成本
任务执行规则参考 · 当前实现
docs/task-rules.html
后台 agent 处理任务的当前线上规则(非提案):复杂度路由(easy/medium/hard)+ 四类执行路径——① 任务拆解(HARD,只读 planner,2–6 子任务·depth≤4·5 字段·三段输出·落库·审批·子任务调度)· ② 方案撰写(MEDIUM)· ③ 任务执行(executor,worktree + verify/checks/diff/双复审硬闸 + auto-merge)· ④ 解冲突(conflict,真 git merge + P0 插队)。含跨类通用规则模型档位(默认 opus-4-8 + 项目可配 + 回退链)、关键状态转移表
HTML规则参考
排障 排障 Runbook · 0
(暂无)
单一入口 · 直接 file:// 打开 · 新增 / 迁移文档请同步登记本页。