Maestro · 文档索引

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

设计设计方案 / 架构设计 · 2

MAESTRO · 架构设计

docs/architecture.html

系统整体架构设计：进程模型（daemon 唯一 DB 写者 / worker 文件协议）、前后端、数据流、调度与执行管道总览。

三类任务执行方法优化方案 · 含实现状态

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

调研知识库调研 · 1

任务执行规则参考 · 当前实现

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:// 打开 · 新增 / 迁移文档请同步登记本页。