optimize-protocol 是面向 VibeHQ 的自主框架工程师技能。VibeHQ 是面向 CLI 编程智能体（Claude Code、Codex CLI、Gemini CLI）的开源多智能体协作协议。该技能的核心任务是：读取运行后的分析数据，深入理解多智能体会话中的失败原因，然后设计并实现真实的代码修改，以避免这些失败在未来会话中重现。
【定位】 该技能明确定位为「框架工程师」而非「参数调优者」。文档强调，把阈值从 200 改到 500 只是权宜之计；而增加内容哈希校验中间件、在重复桩到达编排器前予以拒绝，才是真正的工程。原则是「修复系统而非症状」，让某一类问题从「更不易发生」变为「不可能发生」。
【主要能力与工作流程】 技能按 8 个步骤展开：
-
加载分析数据（当前 + 历史）：从 ~/.vibehq/analytics/runs/<run-id>/ 读取 report_card.json、run_metrics.json、detected_flags.json；读取 ~/.vibehq/analytics/optimizations/history.jsonl 及历次优化报告；构建跨运行趋势分析表。
-
深度分析根因：结合完整指标、标志与趋势，判断问题是「新问题、复发问题，还是上一次修复的副作用」。给出跨迭代处理规则：已修复且保持稳定的不动；修复后又复现的应强化而非重构；新出现的问题往往追溯到上一次修复的副作用；持续 2 次以上迭代的问题需升级为更激进的架构方案。
-
规划变更：在写代码前向用户展示计划，包含跨运行趋势表和每个问题的历史标注（新问题 / 自 vN 复发 / vN 修复的副作用）、证据、拟议修复、涉及文件、预估规模，等待用户确认。
-
实现：修改 VibeHQ 代码库，涉及目录包括 src/hub/、src/spawner/、src/mcp/、src/analyzer/、src/shared/、src/tui/、bin/ 等，遵循 TypeScript、ESM 等既有规范。
-
构建与验证：运行 npx tsup 必须干净编译。
-
更新分析器上下文：若改动框架默认值或新增机制，更新 src/analyzer/llm-analyst.ts 和 src/analyzer/pattern-detector.ts，使未来的分析运行知晓新能力。
-
保存优化变更日志：强制将详细日志写入 ~/.vibehq/analytics/optimizations/optimization-<run-id>-<timestamp>.md，并向 history.jsonl 追加一行记录。
-
输出总结。
【文档中给出的根因模式与「真正的修复」对照示例】
- 桩文件（智能体发布指针而非内容）：真正的修复是在 hub 中做内容校验，哈希检查、拒绝匹配已知桩模式的内容、要求最小内容熵。
- 编排器角色漂移（PM 写代码）：在 spawner 中按角色实施工具白名单，编排器在物理上无法调用 Write/Edit/Bash。
- 上下文膨胀：增加上下文摘要，在 N 轮后自动注入摘要并截断旧消息。
- 过早任务执行（智能体忽略 QUEUED）：重设计任务投递，QUEUED 任务不发送描述，仅在状态变为 READY 时发送完整规格。
- 智能体静默死亡：增加优雅关闭协议，退出前发送 agent:shutting_down，hub 立即重新分配。
- 智能体间 schema 冲突：增加契约系统强制，hub 在接受前按声明的 schema 校验工件 JSON。
- 过度轮询：改为推送式通知，智能体订阅状态变化而非轮询。
- 智能体生成数据而非读取共享文件：增加工件依赖注入，hub 在任务负载中直接发送文件内容。
【使用方式】 以 /optimize-protocol 调用，可传入运行 ID 作为 $ARGUMENTS。文档提供了分析命令示例如 vibehq-analyze <path> --with-llm --save、vibehq start --team <team-name>、vibehq-analyze compare <run-id> <next-id>，以及构建命令 npx tsup。
【限制】 文档未提供关于安装方式、收费与价格、支持的运行环境与依赖版本的完整信息，部分内容暂未提供。该技能依赖 VibeHQ 项目的既有代码库与本地 ~/.vibehq/analytics/ 目录下的分析数据；缺少相关数据时需先运行分析命令。