ln-810-performance-optimizer

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

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

性能优化器

由运行时支持的多轮优化协调器。对优化假设进行性能分析、研究、验证和执行，直至达到目标、检测到性能平台期或耗尽预算。

输入

输入	必填	描述
target	是	要优化的端点、函数或管道
observed_metric	是	当前性能问题
target_metric	否	用户指定或研究得出的目标
max_cycles	否	默认值为 3

目的与范围

• 检测优化是否是合适的工具
• 运行迭代周期：profile -> gate -> research -> target -> context -> validate -> execute
• 将优化产物保存在 .hex-skills/optimization/{slug}/ 下，并将运行时状态保存在 .hex-skills/optimization/runtime/runs/{run_id}/ 下
• 从上一个已检查点的阶段确定性地恢复
• 保持周期摘要可供机器读取

运行时契约

必须读取： 加载 references/ci_tool_detection.md 必须读取： 加载 references/coordinator_runtime_contract.md、references/optimization_runtime_contract.md、references/coordinator_summary_contract.md

运行时 CLI：

node references/scripts/optimization-runtime/cli.mjs start --slug {slug} --manifest-file .hex-skills/optimization/{slug}/manifest.json
node references/scripts/optimization-runtime/cli.mjs status --slug {slug}
node references/scripts/optimization-runtime/cli.mjs record-worker-result --payload '{...}'
node references/scripts/optimization-runtime/cli.mjs record-summary --payload '{...}'
node references/scripts/optimization-runtime/cli.mjs record-cycle --payload '{...}'
node references/scripts/optimization-runtime/cli.mjs checkpoint --phase PHASE_8_EXECUTE --payload '{...}'
node references/scripts/optimization-runtime/cli.mjs advance --to PHASE_9_CYCLE_BOUNDARY

运行时布局

运行时状态按运行划分，而优化产物按 slug 划分：

.hex-skills/optimization/
  runtime/active/ln-810/{slug}.json
  runtime/runs/{run_id}/manifest.json
  runtime/runs/{run_id}/state.json
  runtime/runs/{run_id}/checkpoints.json
  runtime/runs/{run_id}/history.jsonl
  runtime-artifacts/runs/{run_id}/optimization-coordinator/ln-810--{slug}.json
  runtime-artifacts/runs/{run_id}/optimization-worker/{worker}--{child_identifier}.json
  {slug}/context.md
  {slug}/ln-814-log.tsv

工作流

阶段 0：预检

1. 验证：
   • 可识别目标
   • 已提供观测指标
   • Git 工作区干净
   • 存在测试基础设施
2. 检测技术栈和可选的服务拓扑。
3. 推导 slug。
4. 构建清单，包含：
   • slug
   • target
   • observed_metric
   • target_metric
   • execution_mode
   • cycle_config
5. 启动运行时并检查点 PHASE_0_PREFLIGHT。

阶段 1：解析输入

1. 规范化问题陈述。
2. 设置或暂缓设置 target_metric。
3. 检查点 PHASE_1_PARSE_INPUT。

阶段 2：性能分析

1. 计算确定性的子运行元数据：
   • identifier=ln-811--{slug}--cycle-{current_cycle}
   • 子运行 run_id
   • 精确的 summaryArtifactPath=.hex-skills/runtime-artifacts/runs/{parent_run_id}/optimization-worker/ln-811--{slug}--cycle-{current_cycle}.json
2. 通过 child_run 检查点 PHASE_2_PROFILE。
3. 使用子运行的 runId 和精确的 summaryArtifactPath 调用 ln-811-performance-profiler。
4. 从精确的产物路径读取生成的 optimization-worker 摘要信封。
5. 使用 record-worker-result 记录工作器摘要。

阶段 3：工具适用性门控

评估性能分析器的输出：

门控	含义	操作
PROCEED	优化工作有充分依据	继续
CONCERNS	测量结果可用，但并不完美	继续并发出警告
BLOCK	工具不适用、已完成优化或受基础设施限制	汇总并退出
WAIVED	用户覆盖 BLOCK	明确豁免后继续

规则：

• 第 1 个周期遇到 BLOCK -> 以诊断结果结束
• 第 2 个及后续周期因 already_optimized 或 within_industry_norm 遇到 BLOCK -> 以成功停止结束

通过以下内容检查点 PHASE_3_WRONG_TOOL_GATE：

• gate_verdict
• 被阻止时的 stop_reason
• 终止时的 final_result

阶段 4：研究

1. 计算 ln-812 的确定性子运行元数据。
2. 通过 child_run 检查点 PHASE_4_RESEARCH。
3. 使用子运行的 runId 和精确的 summaryArtifactPath 调用 ln-812-optimization-researcher。
4. 读取并记录生成的 optimization-worker 摘要信封。
5. 如果没有剩余假设，则汇总并报告后停止。

阶段 5：设定目标

1. 确定目标指标：
   • 优先使用用户指定的目标
   • 否则使用带有置信度的研究目标
   • 否则默认提升 50%
2. 通过 target_metric 检查点 PHASE_5_SET_TARGET。

阶段 6：编写上下文

1. 构建 .hex-skills/optimization/{slug}/context.md。
2. 包含：
   • 问题陈述
   • 性能图谱
   • 目标指标
   • 假设与冲突
   • 本地代码库调查结果
   • 之前的周期
3. 使用 context_file 设置检查点 PHASE_6_WRITE_CONTEXT。

阶段 7：验证计划

1. 为 ln-813 计算确定性子级元数据。
2. 使用 validation_verdict 和 child_run 设置检查点 PHASE_7_VALIDATE_PLAN。
3. 使用子级 runId 和准确的 summaryArtifactPath 调用 ln-813-optimization-plan-validator。
4. 读取并记录发出的 evaluation-coordinator 摘要封套。
5. 如果判定结果为 NO_GO，暂停运行时，直到用户解决或豁免该问题。

阶段 8：执行

execution_mode=execute：

1. 为 ln-814 计算确定性子级元数据。
2. 使用 child_run 设置检查点 PHASE_8_EXECUTE。
3. 使用子级 runId 和准确的 summaryArtifactPath 调用 ln-814-optimization-executor。
4. 读取并记录发出的 optimization-worker 摘要封套。

execution_mode=plan_only：

1. 不运行 ln-814。
2. 将检查点 PHASE_8_EXECUTE 设置为 skipped_by_mode。

阶段 9：周期边界

1. 使用 record-cycle 记录周期摘要。
2. 评估停止条件：
   • 达到目标
   • 进入平台期
   • 达到最大周期数
   • 没有新假设
3. 如果继续：
   • 在需要时合并之前的分支
   • 递增 current_cycle
   • 设置检查点 PHASE_9_CYCLE_BOUNDARY
   • 返回并推进至 PHASE_2_PROFILE
4. 如果停止：
   • 使用 stop_reason 设置检查点 PHASE_9_CYCLE_BOUNDARY
   • 推进至 PHASE_10_AGGREGATE

阶段 10：汇总

1. 从运行时状态汇总所有周期摘要。
2. 计算累计改进。
3. 设置检查点 PHASE_10_AGGREGATE。

阶段 11：报告

1. 生成最终报告，包含：
   • 各周期摘要
   • 累计改进
   • 最终结果
   • 未达到目标时的差距分析
2. 使用以下内容设置检查点 PHASE_11_REPORT：
   • report_ready=true
   • final_result
3. 使用 record-summary 记录 optimization-coordinator 摘要封套。
4. 仅当报告检查点和协调器摘要均存在后，才完成运行时。

工作器调用（强制）

宿主技能调用： 必须使用 Skill(skill: "...", args: "...") 进行委派。

• Claude：严格按所示方式调用 Skill 工具。
• Codex：如果没有 Skill 工具，请在可用技能中找到指定技能，读取其 SKILL.md，将 args 作为 $ARGUMENTS 处理，执行该技能的工作流，然后携带其结果或产物返回此处。
• 不要内联工作器逻辑，也不要在未执行目标技能的情况下将工作器标记为完成。

阶段	技能	用途
2	ln-811-performance-profiler	构建经测量的性能图谱
4	ln-812-optimization-researcher	研究假设和目标
7	ln-813-optimization-plan-validator	通过 evaluation-platform 审查验证可行性（L2 Coordinator）
8	ln-814-optimization-executor	执行优化攻坚并进行二分排查

Skill(skill: "ln-811-performance-profiler")
Skill(skill: "ln-812-optimization-researcher")
Agent(... Skill(skill: "ln-813-optimization-plan-validator"))
Agent(... Skill(skill: "ln-814-optimization-executor"))

TodoWrite 格式（强制）

- Start ln-810 runtime (pending)
- Run profiler and record summary (pending)
- Apply Wrong Tool Gate (pending)
- Run researcher and record summary (pending)
- Set target metric (pending)
- Write optimization context (pending)
- Validate plan and record summary (pending)
- Execute or skip by mode (pending)
- Record cycle boundary (pending)
- Aggregate results and write final report (pending)

关键规则

• 运行时状态是优化编排的 SSOT。
• 仅通过摘要 JSON 产物使用工作器输出。
• plan_only 是一等执行模式，不是非正式分支。
• 来自 ln-813 的 NO_GO 必须暂停运行时，直到明确解决。
• 周期历史保存在运行时状态中，而非聊天记忆中。
• 终止性诊断结果仍是有效的 DONE 编排结果。

完成定义

• 运行时已启动，并记录了预检和输入检查点
• 确定性地记录了性能分析器和研究人员的摘要
• 已记录错误工具门控结果检查点
• 已记录目标指标和上下文文件检查点
• 已记录验证器摘要；必要时通过 PAUSED 处理 NO_GO
• 已记录执行器摘要，或已记录 skipped_by_mode 检查点
• 已为每个已完成的周期记录周期边界
• 已记录汇总和最终报告检查点
• 运行时已完成，并生成最终结果和无需恢复的终止状态

阶段 12：元分析

可选参考：仅当用户要求运行后元分析或采用协议格式的运行回顾时，才加载 references/meta_analysis_protocol.md。

技能类型：optimization-coordinator。收到请求后，在各阶段完成后运行。使用 optimization-coordinator 格式在聊天中输出。

参考文件

• references/coordinator_runtime_contract.md
• references/optimization_runtime_contract.md
• references/coordinator_summary_contract.md
• ../ln-811-performance-profiler/SKILL.md
• ../ln-812-optimization-researcher/SKILL.md
• ../ln-813-optimization-plan-validator/SKILL.md
• ../ln-814-optimization-executor/SKILL.md

---

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