ln-813-optimization-plan-validator

路径： 文件路径（references/、../ln-*）均相对于此技能目录。

类型： L2 协调器 类别： 8XX 优化

优化计划验证器

用于在执行前验证优化计划的协调器。

必读内容

必读： 加载 references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md、references/evaluation_research_contract.md 必读： 加载 references/agent_delegation_pattern.md 必读： 加载 references/optimization_review_focus.md

Agent 审查政策：运行健康检查；没有可用顾问时记录跳过原因；在修改计划或给出判定前核实每项顾问声明；将传输、身份验证或工具故障视为操作证据，而非优化发现。仅在需要排查评估运行时之外的生命周期／存活状态细节时，才加载 references/agent_review_workflow.md。

目的

• 验证优化假设的可行性
• 计划获批前要求提供有来源支持的研究
• 并行使用外部 Agent，同时进行本地可行性分析
• 按顺序进行合并和优化

输入

主要输入：

• .hex-skills/optimization/{slug}/context.md

必需的上下文章节：

• 性能图谱
• 假设
• 怀疑事项列表
• 测试命令

运行时约定

运行时系列：

• evaluation-runtime

标识符：

• optimization-{slug}

阶段顺序：

1. PHASE_0_CONFIG
2. PHASE_1_LOAD_CONTEXT
3. PHASE_2_AGENT_LAUNCH
4. PHASE_3_RESEARCH_AND_FEASIBILITY
5. PHASE_4_MERGE
6. PHASE_5_REFINEMENT
7. PHASE_6_VERDICT
8. PHASE_7_SELF_CHECK

TodoWrite 格式

必需的待办事项：

• Config
• Load context
• Agent launch
• Research and feasibility
• Merge
• Refinement
• Verdict
• Self-check

协调器根据 references/evaluation_research_contract.md 内联开展研究，并根据 references/agents/prompt_templates/iterative_refinement.md 和 references/agents/prompt_templates/refinement_perspectives.md 内联进行优化。优化顾问会话通过 references/agents/agent_runner.mjs 直接启动。

工作流

阶段 0：配置

1. 确定优化 slug。
2. 构建 required_research=true 的评估运行时清单。
3. 启动 evaluation-runtime。

阶段 1：加载上下文

1. 加载 .hex-skills/optimization/{slug}/context.md。
2. 如果缺少必需章节，则失败。
3. 在需要时生成 Agent 可读的上下文。

阶段 2：启动 Agent

1. 运行健康检查。
2. 启动可用的 Agent。
3. 在 evaluation-runtime 中注册每个已启动的 Agent。
4. 如果没有可用的 Agent，则记录 agents_skipped_reason 并继续。

阶段 3：研究与可行性分析

必需工作：

• 协调器内联开展研究（官方文档、MCP Ref、Context7、当前网络最佳实践）
• 在 Agent 工作期间并行进行本地可行性验证

最低限度的研究方向：

1. 官方文档或标准
2. MCP Ref
3. 针对所涉库的 Context7
4. 当前网络最佳实践研究

可行性检查：

• 文件存在
• 各假设之间不存在无效重叠
• 每项假设均可追溯到分析器或研究证据
• 标记缺乏支持的移除假设
• 有证据支持时，优先采用高层级修复，而非低层级的大幅改动

阶段 4：合并

1. 在合并屏障处同步 Agent。
2. 合并：
   • 本地可行性发现
   • 研究发现
   • Agent 发现
3. 拒绝缺乏支持的建议。
4. 将接受的修正直接应用到 context.md。

阶段 5：优化

根据 references/agents/prompt_templates/iterative_refinement.md 和 references/agents/prompt_templates/refinement_perspectives.md，优化采用两阶段状态机：

• 阶段 1（并行）：dry_run_executor、new_dev_tester、adversarial_reviewer
• 阶段 2（合并后）：final_sweep

规则：

• 阶段 1 并行运行，阶段 2 在合并后运行
• 除非顾问不可用，且原因是运行时故障或已停用，否则不得跳过
• 必须提供清理证据

阶段 6：结论

可能的结论：

• GO
• GO_WITH_CONCERNS
• NO_GO

以下情况判定为 NO_GO：

• 仍存在关键可行性缺口
• 研究结果不支持该计划
• 本地验证和 Agent 审查均拒绝该计划

阶段 7：自检

必需检查：

• 已加载并验证上下文
• 已完成必需的研究
• 已完成本地可行性检查
• 合并前已处理所有必需的 Agent
• 存在合并摘要
• 顾问可用时，存在优化记录
• 已验证清理
• 已记录协调器摘要

摘要规范

写入 summary_kind=evaluation-coordinator。

建议的负载内容：

• status
• final_result
• report_path
• worker_count
• agent_count
• issues_total
• severity_counts
• warnings
• cleanup_verified
• research_completed

完成定义

• 已启动评估运行时
• 已验证优化上下文
• 已完成必需的研究
• 已启动 Agent 或明确跳过
• 已完成可行性分析
• 在 Agent 屏障之后完成合并
• 已执行优化或明确说明理由
• 已给出结论
• 已写入 evaluation-coordinator 摘要
• 运行时已完成

元分析

可选参考：仅当用户要求运行后元分析或按协议格式编写运行反思时，才加载 references/meta_analysis_protocol.md。

如果在协调器运行后提出请求，请根据协议第 7 节分析会话，并在最终优化计划结论中附上按协议格式编写的输出。

参考资料

• 运行时：references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md
• 研究：references/evaluation_research_contract.md
• 审查工作流：references/agent_review_workflow.md、references/agent_delegation_pattern.md
• 重点：references/optimization_review_focus.md

---

版本： 1.0.0 最后更新： 2026-03-15