用途：将对话、代码或文档中的可复用流程提取为工具，或按用户描述生成、优化、晋升工具定义，供开发者、测试等智能体按类别发现和使用。
四种模式：extract 从对话/代码/文档提取流程；generate 按描述生成工具；optimize 改进已有工具步骤与结构；promote 将已有 knowhow 文档原地转为工具（添加 tool: true 与 category）。
存储：knowhow/ 为工具内容唯一来源，specs/ 仅作发现指针，通过 ref: 链接引用，不存步骤。短流程（<10 步）内联；长流程（>=10 步或含代码示例）用 ref 模式。
用法示例（原样）： $maestro-tools-register "extract OAuth PKCE token exchange flow from src/auth/" $maestro-tools-register "generate Stripe webhook idempotency verification" $maestro-tools-register "optimize e2e-checkout tool" $maestro-tools-register "promote RCP-db-migration-rollback as test tool"
流程含三个强制门控：解析→收集、收集→写入、写入→验证，需确认模式、工具名、类别、使用时机与步骤，经 request_user_input 确认。类别按消费者而非内容决定，如 coding、test、review 等；多消费者内容应拆分。发现方式：maestro search 或 maestro load --type knowhow。
限制：所有写入仅限 .workflow/knowhow/ 与 .workflow/specs/，不得修改源代码或路径外文件；spec 未初始化（E001）、类别为空（E003）会阻断；重名给出警告 E002。仅在资料提供的范围内使用，其他收费、平台支持等暂未提供。