用途 improve-orchestrator-system 用于审计一个或多个已安装编排器智能体系统的已完成或已停止会话(按会话 ID),找出 token 浪费与流程偏离的原因,并将每个原因转化为一个具体改进动作。目标是让运行在遵循该问题规范流程的前提下尽可能节省 token。
主要能力
- 检查目标系统安装情况与可用会话:目标维护文件夹中需有 answers.json,缺失时说明无可审计内容,并提示可改用 bootstrap-orchestrator-system。
- 定位转录文件:按会话列出其运行时调用中提及该会话的 Claude Code 与 Copilot CLI 转录文件,不打印内容;支持一个文件包含多个会话、一个恢复会话跨多个文件。
- 生成摘要(digest),并依据审计约定为每个原因产出一条发现,多个会话合并为一条发现。
- 按成本从高到低报告发现,并逐项让用户批准后执行对应动作。
使用方式 在普通会话中运行,而非已安装的某个角色内。默认审计一个会话,仅当用户给出多个 ID 时审计多个,不自行挑选会话。 先检查安装与会话,再定位转录文件,向用户确认要读取的文件(对所有会话一次提问);其他客户端需用户提供路径,无解析器时仅使用会话存储并如实说明。 然后构建摘要:node <skill>/scripts/digest.mjs digest --repo <target> --session <id>... --transcript <id>=<file>... 接着加载 contracts/audit.md 进行审计,按问题每个不同问题读取一次。 最后按 contracts/audit.md 格式报告,再加载 contracts/actions.md,逐条发现征求用户意见,结束时说明已应用、已写入与遗留事项。
适用场景 已安装编排器智能体系统、需要复盘已完成或已停止会话、识别 token 浪费与流程偏离并形成改进动作时使用。
限制
- 流程遵循优先:不得为省 token 而删除、削弱或重排已提供的步骤、检查、验证器或审批门。
- 会话仅作证据:不得修改会话,也不得对其运行运行时操作(运行时操作可能写入会话或响应缓存);只用文件工具读取。
- 客户端转录仅在用户确认后读取。
- 审计需保持低成本:从摘要开始,仅在确认具体发现时通过搜索或行范围打开文件局部,不读取完整转录、design.json 或会话。
- 未经用户对该具体发现的批准不得做任何更改;批准一条发现不等于批准其他发现。
- 测量事实来自脚本,判断结论来自审计者,需分别标注;客户端未记录的使用量报告为不可用,不得记为零。