ln-830-code-modernization-coordinator

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

ln-830-code-modernization-coordinator

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

由运行时支持的代码现代化协调器。将 OSS 替换和包体积优化工作委派给隔离的子运行，记录机器可读的工作器摘要，并生成最终协调器摘要。

---

概述

方面	详情
输入	审计报告、目标模块或现代化范围
输出	汇总的现代化报告及持久化工作器产物
工作器	ln-831（OSS 替换器）、ln-832（包体积优化器）
运行时	.hex-skills/modernization/runtime/runs/{run_id}/

---

工作流

阶段： 预检 -> 分析输入 -> 委派工作器 -> 收集结果 -> 验证摘要 -> 报告

---

运行时契约

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

运行时 CLI：

node references/scripts/modernization-runtime/cli.mjs start --identifier repo-modernization --manifest-file <file>
node references/scripts/modernization-runtime/cli.mjs status --identifier repo-modernization
node references/scripts/modernization-runtime/cli.mjs checkpoint --phase PHASE_2_DELEGATE_WORKERS --payload '{...}'
node references/scripts/modernization-runtime/cli.mjs record-worker-result --payload '{...}'
node references/scripts/modernization-runtime/cli.mjs record-summary --payload '{...}'
node references/scripts/modernization-runtime/cli.mjs advance --to PHASE_3_COLLECT_RESULTS
node references/scripts/modernization-runtime/cli.mjs complete

必需的状态字段：

• worker_plan
• worker_results
• child_runs
• verification_passed
• report_ready
• summary_recorded

领域检查点：

• PHASE_1_ANALYZE_INPUT：目标模块、工作器选择、技术栈检测
• PHASE_2_DELEGATE_WORKERS：每个受委派工作器对应一个 child_run，包含工作器名称、runId 和 summaryArtifactPath
• PHASE_3_COLLECT_RESULTS：已记录的工作器摘要和未解决的失败
• PHASE_4_VERIFY_SUMMARY：最终报告路径、验证结论、摘要就绪状态

保护规则：

• 在每个计划内的工作器都生成有效的 modernization-worker 摘要之前，不得从 PHASE_2_DELEGATE_WORKERS 进入下一阶段
• 在最终报告检查点存在且已记录 modernization-coordinator 摘要之前，不得完成
• 仅使用工作器 JSON 摘要；绝不可根据文字输出推断工作器状态

---

阶段 0：预检

确认现代化请求具有有效范围和确定的运行时目标。

检查项	必需	缺失时的操作
审计报告或目标模块	是	阻止现代化
项目路径	是	阻止现代化
有可用的验证命令	是	如果工作器无法验证更改，则阻止
是否存在该标识符对应的活动运行	否	如果存在冲突的运行，则暂停

---

阶段 1：分析输入

根据项目类型和发现结果选择工作器。

工作器选择：

条件	ln-831	ln-832
审计发现中包含 OSS 候选项	是	否
使用 package.json 的 JS/TS 项目	否	是
两个条件均成立	是	是
仅指定了目标模块	是	如果存在包体积影响，则可选

技术栈检测：

指标	技术栈	ln-832 是否符合条件
package.json + JS/TS 文件	JS/TS	是
*.csproj	.NET	否
requirements.txt 或 pyproject.toml	Python	否
go.mod	Go	否

检查点负载必须包含：

• input_source
• worker_plan
• stack_detection
• skipped_reasons

---

阶段 2：委派工作器

为每个选定的工作器委派一个子运行。子运行是确定性的，并由工件驱动。

根据下方路由规则，使用选定的具体工作器身份进行委派。不要在提示词中编造系列占位符或猜测技能 ID。

委派上下文：

字段	类型	描述
projectPath	string	目标项目的绝对路径
auditReport	string	适用时审计输出的路径
targetModule	string	可选的指定模块路径
identifier	string	稳定的工作器标识符
runId	string	确定性的子运行 ID
summaryArtifactPath	string	工作器摘要的确切 JSON 路径
options	object	验证标志和工作器专属设置

委派规则：

• 如果同时选中了 ln-831 和 ln-832，先启动 ln-831
• ln-832 使用已接受的现代化变更所产生的项目状态，而不是猜测的基准状态
• 等待每个子运行的结果之前，先为其创建检查点
• 使用 record-worker-result 记录每份生成的工作器摘要

---

阶段 3：收集结果

仅汇总经过验证的工作器摘要。

协调器使用的工作器摘要字段：

字段	描述
producer_skill	工作器身份（ln-831 或 ln-832）
summary_kind	必须为 modernization-worker
identifier	稳定的工作器标识符
payload.status	已完成、部分完成或失败
payload.changes_applied	保留的变更
payload.changes_discarded	已丢弃的实验
payload.verification	构建／测试验证结果
payload.artifact_path	工作器负责维护的持久化报告路径
payload.warnings	非阻塞问题

收集输出：

• worker_results
• success_count
• partial_count
• failed_count
• warnings

---

阶段 4：验证摘要

准备最终现代化报告，并验证协调器能否确定性地完成任务。

验证清单：

• 每个计划中的工作器都生成了一份有效的摘要信封
• 汇总计数与记录的工作器结果一致
• 最终报告路径已存在或已准备好写入
• 完成前，report_ready 和 verification_passed 均为 true

故障处理：

1. 保留成功的工作器结果。
2. 在协调器报告中明确标记失败的工作器。
3. 不要编造工作器尚未验证的回滚操作。

---

阶段 5：报告

协调器报告架构：

字段	描述
input_source	审计报告或目标模块
workers_activated	已委派的工作器
modules_replaced	已应用的 OSS 替换
loc_removed	已移除的自定义代码
bundle_reduction	最终包体积缩减摘要
verification_passed	汇总验证结论
per_worker[]	机器可读的工作器结果摘要
warnings[]	跨工作器警告

完成顺序：

1. 写入持久化报告。
2. 为报告路径和验证结论创建检查点。
3. 使用 record-summary 记录 modernization-coordinator 摘要信封。
4. 只有在报告检查点和协调器摘要均已存在后，才完成运行时任务。

---

配置

Options:
  audit_report: "docs/project/codebase_audit.md"
  target_module: ""
  enable_oss_replacer: true
  enable_bundle_optimizer: true
  run_tests: true
  run_build: true

---

错误处理

可恢复：

错误	恢复方式
ln-831 部分结果	如果 ln-832 仍适用，则继续执行
ln-832 失败	保留 ln-831 的结果，并报告部分现代化
某个工作器构建失败	在协调器报告中保留失败信息，继续收集

致命：

错误	操作
未激活任何工作器	以空结果报告结束
运行时验证失败	暂停运行并要求人工干预
计划中的子运行缺少工作器摘要	不要从结果收集阶段继续前进

参考资料

• ../ln-831-oss-replacer/SKILL.md
• ../ln-832-bundle-optimizer/SKILL.md
• ../ln-645-architecture-modernization-auditor/SKILL.md
• references/ci_tool_detection.md

---

TodoWrite 格式（必填）：

- Analyze modernization input (in_progress)
- Delegate ln-831-oss-replacer child run (pending)
- Delegate ln-832-bundle-optimizer child run (pending)
- Aggregate modernization-worker summaries (pending)

Worker 调用（必填）

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

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

阶段	Worker	上下文
2	ln-831-oss-replacer	隔离的子运行，包含 runId 和精确的 summaryArtifactPath
2	ln-832-bundle-optimizer	隔离的子运行，包含 runId 和精确的 summaryArtifactPath

所有 Worker：启动子运行时，检查点记录 child_run 元数据，然后显式调用 Worker 技能，并通过 record-worker-result 使用其生成的 modernization-worker 摘要信封。

# Sequential per selected worker (ln-831 before ln-832 when both selected):
node references/scripts/modernization-runtime/cli.mjs start --skill {worker} --identifier {identifier} --manifest-file {workerManifestPath} --run-id {childRunId} --summary-artifact-path {childSummaryArtifactPath}
node references/scripts/optimization-runtime/cli.mjs checkpoint --phase PHASE_2_DELEGATE --payload '{"child_run":{"worker":"{worker}","run_id":"{childRunId}","summary_artifact_path":"{childSummaryArtifactPath}"}}'
Skill(skill: "{worker}", args: "{identifier} --run-id {childRunId} --summary-artifact-path {childSummaryArtifactPath}")
Read {childSummaryArtifactPath}
node references/scripts/optimization-runtime/cli.mjs record-worker-result --payload-file {childSummaryArtifactPath}

Worker 令牌替换：{worker} 为 ln-831-oss-replacer 或 ln-832-bundle-optimizer。

---

完成定义

• 运行时已启动，并使用经过验证的清单和稳定标识符
• 已分析现代化范围，并根据真实输入选定 Worker
• 为每个选定的 Worker 委派一次子运行
• 每个子运行均生成有效的 modernization-worker 摘要
• 协调器报告汇总替换项、包体积变更、警告和验证结果
• 完成前已记录最终的 modernization-coordinator 摘要

---

阶段 6：元分析

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

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

---

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