一套围绕 maestro 的开发工作流编排系统：把「想法 → 规格 → 计划 → 执行 → 验证」拆成明确步骤，知识驱动、多 CLI 协作、状态可追溯。
给「会用终端、第一次接触 Maestro」的你——跟着 Tab 逐个看：先概览建立心智，再去命令查全量清单，照工作流/案例实操。
把开发拆成想法、规格、计划、执行、验证等明确步骤，每步有产出物（ANL / PLAN / 报告）。
每个任务前先检索已有知识（spec / knowhow / 代码图谱），避免重复踩坑。
把活儿委派给最合适的工具：Claude / Gemini / Codex / Qwen，并行交叉验证。
每个里程碑、每次执行都落在 .workflow/，断点可续。
/ 开头输入。每个 ◆ 是决策点：Ralph 评估实际结果，必要时动态插入 debug → fix → retry 循环。三种质量档：quickstandardfull。
前置：Node ≥ 18、Claude Code CLI（可选 Codex / Gemini）。验证：
maestro install 把 slash 命令/技能/hooks 装进 .claude/，装完重启 Claude Code。
编辑 ~/.maestro/cli-tools.json：
或 maestro config 交互配置。
项目目录下、在 Claude Code 里：
创建 .workflow/（状态 / 知识库 / 会话）。多项目共享知识：maestro workspace link。
/maestro-ralph 是主入口：自动判断生命周期位置并逐步推进，关键节点停下确认。无人值守：
或用 /maestro "意图" 让它按项目状态自动选命令链。
/maestro-analyze "加健康检查接口" → 产出 ANL-xxx
/maestro-plan → 接上一步，产出 PLAN-xxx
/maestro-execute → 代码变更（执行后 Ralph 自动 verify）
/quality-test 或 /quality-review → 验收报告
130+ 命令记不住？先掌握这十二个，覆盖 90% 日常。其余去「命令」Tab 搜。
不知道用啥就用它——描述意图，自动选命令链。
主入口闭环引擎，自动跑完整生命周期。
一行说清的小修复，一步到位。
分析需求/代码，闭环第一步。
基于分析出执行计划。
执行计划写代码。
验收测试（execute 后手动兜底）。
多维代码审查。
看进度和下一步建议。
动手前先检索已有知识（终端）。
把活委派给别的 CLI（终端）。
秒级代码定位（终端）。
共 64 个 slash 命令 + 45 个技能 + 30+ 个 CLI 子命令，按用途分类。徽章：/ slash 在 Claude Code 里输入 · $ cli 终端命令 · ✦ skill 技能。
先定位场景，再照命令块逐行照敲。带 ↻ 的是「对每个阶段循环」。拿不准就 /maestro "意图" 自动选路。
何时：从零起步、需求大而模糊。execute 后 Ralph 自动 verify，再进下一阶段。
何时：已有项目加大功能。跳过 init，先 analyze 摸清代码。
何时：单功能、范围清晰、无需分阶段。
何时：bug 修复或小调整。或直接 /maestro-quick "修复" 一步到位。
何时：只要 PRD/架构/Epics 文档，暂不写代码。
何时：方向未定，多角度发散供决策。
何时：信任自动编排。/maestro 按状态选链，-y 跳过确认。
何时：发现→修复→关闭完整闭环。
何时：要多角色 agent 协作并行推进。
| 档位 | 管线 | 适用 |
|---|---|---|
| quick | verify → CLI-review | 原型 / 快速修复 |
| standard | verify → review → test | 默认，平衡 |
| full | verify → business-test → review → test-gen → test | 生产 / 安全关键 |
每个案例是一段真实命令序列 + 每步在干嘛，复制下来就能跑。
要点：动手前先 search；execute 后 Ralph 自动 verify，再手动 quality-test + security-audit 兜底；最后把经验写回 spec，下次自动注入。
要点：brainstorm/blueprint 收敛方向 → roadmap 拆里程碑 → 逐阶段闭环 → milestone-audit 查集成缺口后 complete 进下一个。
要点：先用 maestro explore 秒级定位代码位置（带具体关键词命中率高），再用 odyssey-debug 走「考古→诊断→修复→确认→泛化」闭环。
要点：delegate 后台异步、不阻塞；collab 多视角交叉验证，适合架构选型这类需要多个独立判断的决策。
❌ 别把 5 个词塞一句；✅ 概念和符号分开搜。先 maestro kg sync 建索引，maestro search-daemon start 提速。
/maestro-* 在 Claude Code 对话框；maestro * 在终端。工作流编排走 slash，基础设施（检索/委派/看板）走 CLI。
没有 /maestro-verify——verify 是 Ralph 自动步骤，手动验收用 /quality-test。
默认 --mode analysis（只读）；要改文件才 --mode write。后台异步，用 maestro delegate status 查。角色有回退链，前一个不可用自动切下一个。
grep-first 快速搜索，带具体关键词/符号名命中率高，问太泛会答歪。适合代码定位，开放式架构分析仍交给 delegate / collab。
做完一个任务，把决策写回：maestro spec add <cat> ... 或 /manage-knowhow-capture。下次相关任务会自动注入，越用越聪明。
类别路由：决策→arch，模式→coding，坑→debug/learning，规则→review，测试→test。
不知道走哪条路：/maestro "意图" 自动选链；要闭环自纠错：/maestro-ralph；要跑到验收为止：/odyssey-planex。
原型/小修用 quick；日常 standard；生产/安全关键 full。Ralph 会按任务自动套，也可显式指定。
skip / @ts-ignore / 空 catch / as any / 超长 timeout 都是「藏 bug」不是「修 bug」。遇到根因走 /quality-debug 或 /odyssey-debug。
130+ 命令别慌，先按场景对号入座。
| 你的场景 | 用这个 | 为什么 |
|---|---|---|
| 完全不确定走哪条 | /maestro "意图" | 按项目状态自动匹配 40+ 命令链 |
| 想无人值守跑完整闭环 | /maestro-ralph -y | 自适应引擎，决策点自动 debug→fix |
| 一行说清的小修复 | /maestro-quick | 跳过可选 agent，一步到位 |
| 范围清晰的标准功能 | analyze → plan → execute | 手动可控的闭环三件套 |
| 要反复迭代到验收达标 | /odyssey-planex | plan→execute→严格 verify→fix 长循环 |
| 顽固 / 偶发 bug | /odyssey-debug | 考古→诊断→修复→泛化，不放过根因 |
| 大功能要多角色并行 | /team-planex 等 | coordinator 编排 worker 流水线 |
| 只想查代码在哪 | maestro explore | 秒级 grep-first 定位（终端） |
注入类：每次提问 / 子代理调用前，自动把相关 spec / 知识图谱 / 技能上下文注入，让 AI 带着项目知识干活。
守卫类：preflight-guard / spec-validator 在写文件、跑命令前校验，命中受保护文件或规格冲突才拦，平时放行。
maestro 装了 45+ 个专用 subagent（规划 / 执行 / 审查 / 探索 / 测试 / 调试…），由命令和团队技能自动调度，一般不用手动调。
团队技能（team-*）的模式：一个 coordinator 编排，多个 worker 按角色并行干活，跨检查点有 supervisor 观测质量。
关系：命令 决定做什么 → agent 实际执行 → hooks 在两侧注入知识 / 守卫边界。
| Ralph | 11 态自适应生命周期引擎，只「决策」拼命令链，不亲自执行 |
| Odyssey | 长跑自纠错循环，跑到验收标准达成为止 |
| ANL-xxx | analyze 产出的分析报告 ID |
| PLAN-xxx | plan 产出的执行计划 ID |
| spec | 项目规格：决策 / 模式 / 规则，会被自动注入给 AI |
| knowhow | 可复用知识：模板 / 配方 / 技巧 |
| kg | 知识图谱（MaestroGraph）：代码符号 + 调用关系 |
| delegate | 把任务委派给别的 CLI（codex / gemini…），后台异步 |
| explore | 轻量代码搜索 agent，直连 OpenAI 兼容端点 |
| milestone | 里程碑：roadmap 拆出的大阶段，可 fork 并行 / audit 审计 / complete 归档 |
| quality 档 | quick / standard / full 三种验证强度 |
| .workflow/ | 项目状态、知识库、会话记录的存放目录 |
| overlay | 对命令的非侵入式补丁，不改原命令 |
| MCP | Model Context Protocol；maestro 也可作为 MCP server |
| ~/.maestro/cli-tools.json | CLI 工具配置（启用哪些、默认模型） |
| ~/.maestro/api-explore.json | explore 端点配置（OpenAI 兼容） |
| ~/.claude/CLAUDE.md | 全局指令 / 工作准则 |
| ~/.claude/settings.json | Claude Code 设置（hooks / 权限） |
| .workflow/specs/ | 项目规格 |
| .workflow/kg/ | 知识图谱 |
| .workflow/knowhow/ | knowhow 条目 |
| .workflow/explore/ | explore 会话记录 |
先建索引：