maestro

【用途】\nMaestro 的定位是“架构治理框架”（Governance Protocol），用于在管理复杂代码仓库时约束 AI 代理的行为，使其从反应式编码者转变为主动的软件架构师。其核心目标是强制纪律、维持项目连续性，并编排专门化的技能。\n\n【核心原则】\n资料列出若干强制性的主要指令：\n- 启动法则：每次会话必须按严格顺序读取文件，依次为 SKILL.md（治理）、agents/（角色）、skills/（领域专长），架构连续性不可妥协。\n- 苏格拉底式门禁：任何执行前必须分析用户意图，并至少提出一个关于范围、边界情况或背后“为什么”的战略性问题。\n- 架构优先：复杂任务需要 implementation_plan.md（RFC-Lite），不得在假设之上编写生产代码。\n- TDD 铁律：没有先行失败的测试，就不写生产代码，遵循红-绿-重构。\n- 验证矩阵：每个交付物在标记为“完成”前必须以证据验证。\n\n【项目结构】\n- .maestro/：项目的“大脑”，存放长期记忆（brain.jsonl）与状态文件；资料说明其通过 hooks 自动创建，不要手动初始化。\n- agents/：角色与编排逻辑，grandmaster.md 定义精英架构师的行为。\n- hooks/：在 AI 生命周期中触发的自动化脚本（如会话开始、记忆同步）；资料注明这些 hook 面向 Claude Code CLI，若使用会跳过 hook 的 IDE 工具，可忽略并手动执行协议。\n- skills/：专长库（前端、后端、调试、QA），由 Maestro 进行委派。\n- commands/：自定义战术工作流与 CLI 扩展。\n- SKILL.md：整个框架的基础治理协议文档。\n\n【持久记忆】\nMaestro 在 .maestro/brain.jsonl 中维护长期记忆系统：每次交互开始时审计技术栈、架构模式与近期压缩摘要；所有关键决策、已完成任务与文件变更需回写到“大脑”，以保证跨会话连续性。\n\n【编排与技能路由】\nMaestro 扮演“大师指挥”的角色，将领域工作委派给内部专项技能。路由协议要求先读取 agents/ 中的核心角色以确立架构立场，再根据任务需求动态选择并读取 skills/ 下相关的 SKILL.md。资料给出的路由示例包括：UI/UX 智能路由到 skills/frontend-design/SKILL.md，强制物理感动画与反 AI 审美；后端与 API 设计路由到 skills/backend-design/SKILL.md，强制零信任架构与严格 API 契约；外科式调试路由到 skills/debug-mastery/SKILL.md，采用四阶段系统化诊断；自主 QA（Ralph Wiggum）为任何 bug 修复或优化任务触发自愈迭代循环。\n\n【执行循环】\n1. 分析：识别语言、确定技术栈并追问需求。\n2. 规划：使用 planning-mastery 制定简短的高层战术序列。\n3. 执行：逐个任务以外科式精度执行，禁止 // TODO 注释或惰性占位符。\n4. 验证：运行测试、通过脚本进行 UX 审计，并提供功能证明。\n\n【理念】\n“紧迫从来不是糟糕架构的借口。信任协议，编排未来。”\n\n【适用场景与限制】\n适用场景：需要治理与纪律的复杂代码仓库管理、架构决策与连续性维护、跨前/后端/调试/QA 的专项任务编排。\n限制与未提供信息：资料未说明具体收费、价格、支持的平台范围或性能数据；hooks 被描述为面向 Claude Code CLI，其他 IDE 工具可能跳过 hook，此时需手动执行协议。