用途：maestro-amend 用于生成覆盖层（overlay），修补工作流命令的不足。它先收集信号，诊断哪些属于命令缺陷，再按目标命令与章节分组生成 overlay，最终交给安装命令落地。
信号来源：可通过 --from-verify <dir>（读取 verification.json，取验证失败导致的工作流缺口）、--from-review <dir>（读取 review.json，取代码审查中的流程缺陷）、--from-session <id>（会话产物）、--from-issues ISS-xxx,...（issues.jsonl，取可追溯到命令缺陷的议题）以及 --scan（扫描 .workflow/ 自动发现相关信号）。也可直接传入位置文本作为用户描述。多种来源可组合；既无标志也无描述时进入交互模式（扫描并请求输入）。
主要能力：按信号模式映射到目标章节与注入方式，例如缺失前置检查或门禁映射到 execution 的 prepend，缺失后置步骤或验证映射到 execution 的 append，缺失阅读或上下文映射到 required_reading / deferred_reading 的 append，成功标准不完整映射到 success_criteria，缺失错误处理映射到 error_codes，全新关注点使用 new-section。读取原始命令源以确认章节存在，并区分命令缺陷与代码缺陷（后者跳过并建议改用 $maestro-quick）。
使用方式：控制参数包括 --dry-run（仅预览，不安装）与 -y（跳过确认）。CLI 定向通过 "cli" 配置："claude"（默认，修补 .claude/commands/）、"codex"（修补 .codex/skills/）、"both"。源路径映射为：claude 用 $PKG_ROOT/.claude/commands/<name>.md，codex 用 .codex/skills/<name>/SKILL.md。安装命令为 maestro overlay add ~/.maestro/overlays/amend-{slug}.json，验证失败时修正 JSON 最多重试 2 次。
输出与限制：输出为 ~/.maestro/overlays/amend-{slug}.json，必要时附带 ~/.maestro/overlays/docs/amend-{slug}.md。所有文件写入必须只针对 ~/.maestro/overlays/，绝不直接修改 .claude/commands/*.md，覆盖层安装由 maestro overlay add 处理。错误码包括 E001（无信号）、E003（信号全为代码缺陷）、E004（重试后校验失败）、W001（部分信号被跳过）、W002（目标命令已有 >= 3 个覆盖层，建议合并）。
适用场景：当验证失败、代码审查或会话记录显示流程命令缺少步骤、检查、上下文或错误处理时，用本技能生成覆盖层修补。其他细节（如具体收费标准、平台支持范围）暂未提供。