用途：maestro-overlay 是一个技能，用自然语言把指令转成命令覆盖层（overlay），或用工作流缺陷信号批量自动生成覆盖层。
两种模式：默认（intent）交互式把一条自然语言指令转成一个覆盖层；--amend 为信号驱动自动生成，从多个来源收集工作流缺陷信号，诊断哪些命令需要补充，批量生成针对性覆盖层。
覆盖层模型：JSON 文件含 name、targets[]（命令名）、patches[]；每个 patch 含 section（XML 标签）、mode（append/prepend/replace/new-section）、content。可用 section：purpose、required_reading、deferred_reading、context、execution、completion、invariants、error_codes、success_criteria。
存放位置：用户覆盖层 ~/.maestro/overlays/.json；共享文档 ~/.maestro/overlays/docs/.md，可在 patch 内容中用 @~/.maestro/overlays/docs/*.md 引用；随附示例在 ~/.maestro/overlays/_shipped/，只读。
使用方式（默认模式）：解析意图后确定目标命令与注入点，从 $PKG_ROOT/.claude/commands/<name>.md 读取原始来源，选择 section 与 mode，预览注入点并确认，可选配置技能链，起草 JSON，经内容审批后安装：maestro overlay add ~/.maestro/overlays/<slug>.json。列出与删除由 maestro overlay list 管理（ink TUI 支持交互删除），本技能只负责创建。
amend 模式信号来源：--from-verify <dir>（verification.json）、--from-review <dir>（review.json）、--from-session <id>（会话产物）、--from-issues ISS-xxx,...（issues.jsonl）、--scan（自动扫描 .workflow/）、位置文本（用户描述）。可组合；无参数时进入交互。控制项：--dry-run 预览不安装，-y 跳过确认。输出为 ~/.maestro/overlays/amend-{slug}.json 及可选配套文档。
限制：所有文件写入仅限 ~/.maestro/overlays/，本技能不直接修改 .claude/commands/*.md，命令文件补丁由 maestro overlay add 处理；amend 模式必须读 $PKG_ROOT/.claude/commands/ 原始来源，代码缺陷不得用覆盖层修补，应转 /maestro-companion 或 --gaps 步骤计划；补丁前需确认目标 section 存在于原始来源，缺失则用 new-section。错误码包括 E001（无信号）、E002（路径无效）、E003（全部为代码缺陷）、E004（两次重试后校验失败）、W001、W002。关于收费、价格、平台等事实暂未提供。