用途:管理知识库与运行(Run)期间的知识生命周期,按用户意图在关键字触发时确定性地调用对应执行文档或 CLI 命令,歧义时展示操作表请用户选择。
主要能力与命令:audit(只读审计,scope 仅 spec|knowhow|all,无 --apply/删除/清除路径,--prune 只生成确定性 prune_plan);normalize(先生成 --report <path>,审阅后再对同一路径 --apply;来源或仓库身份变化则报告失效);review(maestro knowledge review <session-id>,支持 --refresh 对账、--resolve <id> --as <choice> --reason "..." 裁决);stage(暂存候选,支持 --signal、--signal-ids);promote(晋升,--all 晋升所有符合条件候选,--include-observed 已移除);harvest(从工件/session 提取);wiki(连接、摘要、健康、搜索、清理、统计);extractors;domain(注册领域术语)。
使用方式:命令操作如 maestro knowledge audit --scope all、maestro knowledge stage <target> "<title>" --content-file <path|->、maestro knowledge review <session-id> [--refresh] [--resolve <id> --as <choice> --reason "..."]。暂存内容必须来自临时文件或 stdin,不可内联;--signal-ids 用逗号分隔。Run 中可复用 knowhow 用 maestro knowledge stage knowhow ... 暂存,项目 knowhow 仅在显式晋升时写入。普通 Knowhow 创建为 maestro knowhow add --type <type> --title "<title>" --content-file <path>;普通 Spec 为 maestro spec add <category> "<title>" "<content>"。九种 Knowhow 类型:session|tip|template|recipe|reference|decision|asset|blueprint|document。
限制:仓库权限由宿主掌控,普通当前仓库写入省略 targetRepoId,仅在宿主提供精确稳定 UUID 与实时写能力时才传;不得从 cwd、仓库名、别名或路径推断。审计发现与剪枝建议仅作证据,不得自动转为生命周期变更,也不得仅因使用率低而剪枝。需完成对账,语义重复/冲突/取代候选未解决前晋升必须 fail closed。资料未提供平台、收费、价格等信息。