ln-810-performance-optimization-coordinator

路径： 文件路径（shared/、references/、../ln-*）均相对于技能仓库根目录。如果在 CWD 中找不到，请定位此 SKILL.md 目录，并向上一级找到仓库根目录。

ln-810-performance-optimization-coordinator

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

通过委派给 L3 工作器来协调性能优化：ln-811（算法）、ln-812（查询）、ln-813（运行时）。当输入相互独立时，工作器会并行运行。

---

概述

方面	详情
输入	目标文件/模块或审计报告（ln-650 输出）
输出	经验证并附有证明的优化代码
工作器	ln-811（算法）、ln-812（查询）、ln-813（运行时）

---

工作流

阶段： 预检 → 分析输入 → 委派 → 收集 → 验证 → 报告

---

阶段 0：预检

检查项	必需	缺失时的操作
目标文件或审计报告	是	阻止优化
Git 工作区干净	是	阻止（需要干净的基线以便还原）
测试基础设施	是	阻止（工作器需要测试来决定保留或丢弃）

必须读取： 加载 shared/references/ci_tool_detection.md，以检测测试/构建工具。

---

阶段 1：分析输入

输入来源

来源	检测方式	激活的工作器
docs/project/persistence_audit.md	存在 ln-650 输出	ln-812（查询）+ ln-813（运行时）
目标文件 + 函数	用户指定	ln-811（算法）
完整审计报告	包含所有 ln-65X 部分	全部三个工作器

工作器选择

条件	ln-811	ln-812	ln-813
已指定目标函数	是	否	否
存在 ln-651 发现	否	是	否
存在 ln-653 发现	否	否	是
所有审计发现	有条件*	是	是

*仅当审计中识别出特定算法低效问题时，才激活 ln-811。

---

阶段 2：委派给工作器

关键： 所有委派都使用 Agent 工具，并设置 subagent_type: "general-purpose" 和 isolation: "worktree"——每个工作器都根据 shared/references/git_worktree_fallback.md 创建自己的分支。

委派协议

FOR each selected worker:
  Agent(description: "Optimize via ln-81X",
       prompt: "Execute optimization worker.

Step 1: Invoke worker:
  Skill(skill: \"ln-81X-{worker}\")

CONTEXT:
{delegationContext}",
       subagent_type: "general-purpose",
       isolation: "worktree")

委派上下文

字段	类型	说明
projectPath	string	项目的绝对路径
auditReport	string	persistence_audit.md 的路径（如适用）
targetFile	string	目标文件路径（如适用）
targetFunction	string	目标函数名称（如适用）
options.runTests	bool	优化后运行测试
options.runLint	bool	优化后运行 lint

并行执行

工作器	可并行	原因
ln-812 + ln-813	是	文件不同，修复类型不同
ln-811 + ln-812	视情况而定	仅在目标文件不同时
ln-811 + ln-813	视情况而定	仅在目标文件不同时

规则：

• 如果工作器的目标是同一个文件，则按顺序运行（先 ln-811，再 ln-812/813）。
• 存在依赖关系的工作器共用分支： 如果工作器 B 依赖工作器 A 的输出（例如，ln-813 需要 ln-812 的查询变更），则在工作器 A 的分支中启动工作器 B，这样 B 就能看到 A 的变更。

---

阶段 3：收集结果

每个工作器都会生成一个隔离分支。协调器汇总各分支报告。

工作器分支

工作器	分支模式	内容
ln-811	optimize/ln-811-{function}-{ts}	包含基准测试的算法优化
ln-812	optimize/ln-812-{ts}	查询优化
ln-813	optimize/ln-813-{ts}	运行时优化

结果架构

字段	类型	描述
worker	string	ln-811、ln-812 或 ln-813
status	enum	success、partial、failed
branch	string	Worker 的结果分支名称
fixes_applied	int	保留的优化数量
fixes_discarded	int	丢弃的尝试数量
details	object	Worker 专属报告

---

第 4 阶段：汇总报告

每个 Worker 都在自己的分支中独立验证（测试、构建和 lint 均由 Worker 自行运行）。协调器不会重新运行验证，也不会还原 Worker 的更改。

失败时

1. 将测试失败的分支在报告中记录为“failed”
2. 用户独立审查失败的分支

---

第 5 阶段：报告摘要

报告架构

字段	描述
input_source	审计报告或目标文件
workers_activated	运行的 Worker
total_fixes_applied	所有 Worker 的修复数量总和
total_fixes_discarded	所有 Worker 丢弃的修复数量总和
build_verified	PASSED 或 FAILED
per_worker[]	各 Worker 的报告
algorithm_improvement	基准测试提升百分比（仅 ln-811）

---

配置

Options:
  # Input
  audit_report: "docs/project/persistence_audit.md"
  target_file: ""
  target_function: ""

  # Workers
  enable_algorithm: true
  enable_query: true
  enable_runtime: true

  # Verification
  run_tests: true
  run_build: true
  run_lint: true

  # Safety
  revert_on_build_failure: true

---

错误处理

可恢复错误

错误	恢复措施
Worker 超时	记录超时，继续处理其他 Worker
单个 Worker 失败	还原该 Worker 的更改，并报告部分成功
构建失败	还原最后一个 Worker 的更改，并重新验证

致命错误

错误	操作
未激活任何 Worker	报告“未找到优化目标”
所有 Worker 均失败	报告失败情况，并建议手动审查
Git 状态不干净	阻止操作，并提示“请先提交或暂存更改”

---

参考资料

• ../ln-811-algorithm-optimizer/SKILL.md
• ../ln-812-query-optimizer/SKILL.md
• ../ln-813-runtime-optimizer/SKILL.md
• shared/references/ci_tool_detection.md

---

完成定义

• 已分析输入（审计报告或目标文件/函数）
• 已根据输入类型选择适当的 Worker
• 已通过工作树隔离委派 Worker（isolation: "worktree"）
• 每个 Worker 都会生成独立分支并推送到远程
• 协调器报告汇总各 Worker 的结果（分支、修复数量、状态）

---

第 6 阶段：元分析

必须阅读： 加载 shared/references/meta_analysis_protocol.md

技能类型：optimization-coordinator。所有阶段完成后运行。使用 optimization-coordinator 格式在聊天中输出。

---

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