ln-220-story-coordinator

用途\n该技能是 Story 规划协调器，属于 L2 领域协调器、2XX 规划类。它的目标是为一个 Epic 组装规划上下文、做聚焦的标准研究、先构建理想的 Story 计划，再检测路由与模式，最后将 Story 的创建或重规划委派给独立 worker。当某个 Epic 需要做 Story 分解时使用。\n\n主要能力\n- 为一个 Epic 组装规划输入，仅收集会影响 Story 分解的内容：Epic 范围、成功标准、已知画像与约束、项目任务提供方。\n- 仅在会改变 Story 技术说明或实现约束时，做聚焦的标准研究；研究不扩大 Story 范围。若存在 researchgraph 布局，先用 verify_index 再查询相关的目标、假设、证据或运行结果，用于支撑 Story 范围、就绪度与技术说明。\n- 在查看现有 Story 之前，先构建理想 Story 计划，规则包括：仅垂直切片、Epic 需要时产出 5-10 个 Story、简洁的 Story 陈述与可观察的验收标准（AC）、计划内不写编排性文字、委派的 AC 要说明为执行者提供什么（上下文、指令、工具、配置）。\n- 按 Epic 分组路由规划出的 Story。快路径是全部 Story 留在已解析的 Epic 中；仅在路由有歧义或需要确认时暂停。\n- 按 Epic 分组检测模式：CREATE、REPLAN、ADD。\n- 在委派前批量准备子清单与产物：最终确定路由分组、生成 worker 清单、为每个子项预先计算 run_id 与 summary_artifact_path，并在执行前对预期 worker 集合做检查点。\n- 委派：CREATE 或 ADD 路径交给 ln-221-story-creator，REPLAN 路径交给 ln-222-story-replanner。worker 保持可独立运行；托管模式下由协调器通过 planning-worker-runtime 启动，传入 runId 与 summaryArtifactPath，将启动元数据存入 child_run，再通过 record-epic 记录 worker 产物。\n- 收尾：在所有预期 worker 摘要被记录后进行；为父运行时构建一份 story-plan 摘要，通过 node references/scripts/story-planning-runtime/cli.mjs record-plan-summary 写入，并在进入自检前持久化产物。\n- 模板合规门：按配置的 tracker 提供方获取每个新建 Story（按 references/tracker_provider_contract.md 的 getStory 操作），运行 planning-runtime/lib/template-compliance.mjs 的 validateTemplateCompliance(description, 'story')；所有 Story 必须通过（9 个章节按顺序），在状态中记录 template_compliance_passed，未通过则阻止自检。\n- 自检：确认阶段覆盖、计划与产出的 Story 数量、无缺失 Epic 分组。\n\n使用方式\n输入参数：epicId（必填，要分解的 Epic）；autoApprove（可选，若为 false，运行时会在预览确认处暂停）。\n运行时族为 story-planning-runtime，标识符为 epic-{epicId}，阶段依次为 PHASE_0_CONFIG、PHASE_1_CONTEXT_ASSEMBLY、PHASE_2_RESEARCH、PHASE_3_PLAN、PHASE_4_ROUTING、PHASE_5_MODE_DETECTION、PHASE_6_DELEGATE、PHASE_7_FINALIZE、PHASE_8_SELF_CHECK，终止阶段为 DONE、PAUSED。\n执行前必须加载的参考文件包括 coordinator_runtime_contract.md、story_planning_runtime_contract.md、coordinator_summary_contract.md、environment_state_contract.md、storage_mode_detection.md、problem_solving.md。当 Epic、来源文档或现有 Story 引用 H/G/run ID，或 researchgraph 布局可能改变 Story 分解时，还需加载 researchgraph_mcp_usage.md。\n路径说明：references/、../ln-* 等路径相对于本技能目录。\nworker 调用为强制委派：宿主技能调用 Skill(skill: "...", args: "...")。Claude 中直接调用 Skill 工具；Codex 中若无 Skill 工具，则定位同名技能、阅读其 SKILL.md，将 args 视为 $ARGUMENTS 执行该技能工作流并返回结果/产物。不得内联 worker 逻辑，也不得在未执行目标技能的情况下标记 worker 完成。\n委派启动命令示例：node references/scripts/planning-worker-runtime/cli.mjs start --skill {worker} --identifier {identifier} --manifest-file {workerManifestPath} --run-id {childRunId} --summary-artifact-path {childSummaryArtifactPath}。\nchildSummaryArtifactPath 形如 .hex-skills/runtime-artifacts/runs/{parent_run_id}/story-plan-worker/{worker}--{identifier}.json。\n合并摘要时消费 worker 摘要，而非 worker 的自由文本叙述。\n\n适用场景\n当某个 Epic 需要 Story 分解时，用于创建、重规划或追加每个 Epic 的 5-10 个 Story，涵盖标准研究与多 Epic 路由。\n\n限制与约束\n- 关键规则：先构建理想计划再查看现有 Story；研究仅用于改进技术说明与实现现实性；路由或预览批准不能只保留在聊天状态中；仅对只读准备做批处理，除非运行时语义明确允许，不要跨路由分组并行执行 Story 变更；当应由 worker 创建或更新 Story 时，不要直接创建或更新；消费 worker 摘要而非自由文本叙述。\n- 待决事项（缺上下文、路由确认、ADD 与 REPLAN 歧义、autoApprove=false 时的预览确认）应使用运行时的 PAUSED + pending_decision，不要仅保存在聊天中。\n- Worker 不认识协调器、不读取运行时状态、保持独立、可接收 summaryArtifactPath，并始终返回共享摘要信封。子 worker 摘要类型为 story-plan-worker，协调器输出类型为 story-plan。\n- 完成定义包括：以 Epic 范围标识符启动运行时、各阶段检查点、记录所有预期 worker 摘要、记录协调器 story-plan 摘要、最终结果检查点、所有新建 Story 通过模板合规、自检通过。\n- 版本 5.0.0，最后更新 2026-02-03。\n- 可选的元分析参考仅在用户要求运行后元分析或协议格式运行反思时加载 references/meta_analysis_protocol.md；本技能类型为 planning-coordinator，被请求时在所有阶段完成后运行，按协议格式输出到聊天。\n- 关于收费、价格、平台支持范围等事实，资料暂未提供。