用途
ln-221-story-creator 是一个独立优先（standalone-first）的 Story 创建 Worker，用于在 Epic 已具备 IDEAL 计划后生成 Story 文档。它既可以作为协调器流程的一部分被调用，也可以直接独立调用，两种方式下其公共契约保持一致。
主要能力
- 按模板定义的 9 段结构生成 Story 文档，段落包括：Story、Context、Acceptance Criteria、Implementation Tasks、Test Strategy、Technical Notes、Definition of Done、Dependencies、Assumptions。
- 在创建前进行 INVEST 校验与 AC 数量限制校验，拒绝不通过 INVEST 或超出 AC 限制的 Story。
- 将标准研究（standards research）仅插入到 Technical Notes 中，而非 AC 中。
- 通过配置的 tracker provider 创建 Story，并更新看板（kanban）。
- 输出结构化的 story-plan-worker 摘要信封。
使用方式
该技能在执行前必须加载以下参考文档：references/planning_worker_runtime_contract.md、references/coordinator_summary_contract.md、references/environment_state_contract.md、references/storage_mode_detection.md、references/creation_quality_checklist.md、references/template_loading_pattern.md。
核心输入包括：epicData、idealPlan 或 appendMode + newStoryDescription、standardsResearch、teamId、autoApprove。可选传输输入包括：runId、summaryArtifactPath。该 Worker 在无调用方提供的 runId 且无 summaryArtifactPath 时仍可完全使用；在独立模式下，它会在发出摘要信封前自行生成 run_id。
运行时家族为 planning-worker-runtime，标识符为 epic-{epicId}。执行阶段依次为：PHASE_0_CONFIG、PHASE_1_RESOLVE_CONTEXT、PHASE_2_LOAD_TEMPLATE、PHASE_3_GENERATE_STORIES、PHASE_4_VALIDATE_STORIES、PHASE_5_CONFIRM_OR_AUTOAPPROVE、PHASE_6_APPLY_CREATE、PHASE_7_UPDATE_KANBAN、PHASE_8_WRITE_SUMMARY、PHASE_9_SELF_CHECK。
工作流程：解析任务 provider 与 Epic 上下文（若尚未提供）；加载 Story 模板；按模板段落生成 Story 文档；将标准研究插入 Technical Notes；在创建前校验 INVEST 与 AC 限制；除非 autoApprove=true，否则显示预览；通过配置的 tracker provider 创建 Story；更新看板；写入 story-plan-worker 摘要；返回结构化摘要。
在托管子运行模式下，调用方以 --run-id 和 --summary-artifact-path 启动运行时，运行时将最终摘要产物直接写入调用方提供的路径，父协调器记录生成的 story-plan-worker 产物。在独立模式下，运行时自行生成 run_id，仍返回相同的结构化摘要信封，除非提供 summaryArtifactPath，否则产物写入是可选的。
输出契约
始终构建结构化摘要信封，包含：schema_version、summary_kind=story-plan-worker、run_id、identifier、producer_skill=ln-221、produced_at、payload。payload 字段包括：mode、epic_id、stories_planned、stories_created、stories_updated、stories_canceled、story_urls、warnings、kanban_updated、research_path_used。若提供 summaryArtifactPath，则将同一 JSON 摘要写入该路径；若未提供，则仅在结构化输出中返回同一摘要。托管产物路径模式为：.hex-skills/runtime-artifacts/runs/{parent_run_id}/story-plan-worker/ln-221--{identifier}.json。
适用场景
适用于 Epic 已具备 IDEAL 计划、准备进入 Story 拆分的规划阶段。可作为独立 Worker 直接调用，也可作为协调器流程的一部分。
限制与关键规则
- 必须严格保持模板定义的 Story 结构。
- 标准研究只能插入 Technical Notes，不能插入 AC。
- 拒绝未通过 INVEST 或超出 AC 限制的 Story。
- 在 tracker createStory 之前必须 STOP，验证正文中 9 个段落全部存在；缺少段落时 PreToolUse hook 将阻止创建。
- 必须保持独立可用，绝不依赖协调器运行时状态来运行。
完成定义
Story 模板已加载并遵守；Story 文档已生成；INVEST 校验通过；Story 已在 provider 特定存储中创建；看板已更新；结构化摘要已返回；当提供 summaryArtifactPath 时摘要产物已写入。
版本：3.0.0；最后更新：2025-12-23。