ln-222-story-replanner

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

Story 重新规划

类型： L3 Worker 类别： 2XX 规划

用于 Story 重新规划的独立优先 Worker。它会比较理想的 Story 意图与现有 Story，并执行由此得出的操作。

必须阅读

执行前加载以下文件：

• references/planning_worker_runtime_contract.md
• references/coordinator_summary_contract.md
• references/environment_state_contract.md
• references/storage_mode_detection.md
• references/template_loading_pattern.md
• references/replan_algorithm_stories.md

输入

核心输入：

• epicData
• idealPlan
• existingStoryIds
• standardsResearch
• teamId
• autoApprove

可选传输输入：

• runId
• summaryArtifactPath

即使调用方未提供 runId 或 summaryArtifactPath，Worker 也必须保持完整可用。在独立模式下，它会在输出摘要信封前自行生成 run_id。

运行时

运行时系列：planning-worker-runtime

标识符：

• epic-{epicId}

阶段：

1. PHASE_0_CONFIG
2. PHASE_1_RESOLVE_CONTEXT
3. PHASE_2_LOAD_EXISTING_STORIES
4. PHASE_3_CLASSIFY_REPLAN
5. PHASE_4_CONFIRM_OR_AUTOAPPROVE
6. PHASE_5_APPLY_REPLAN
7. PHASE_6_UPDATE_KANBAN
8. PHASE_7_WRITE_SUMMARY
9. PHASE_8_SELF_CHECK

托管子运行模式：

• 调用方使用 --run-id 和 --summary-artifact-path 启动运行时
• 运行时将最终摘要制品直接写入调用方提供的路径
• 父级协调器记录生成的 story-plan-worker 制品

独立模式：

• 运行时自行生成 run_id
• 运行时仍会返回相同的结构化摘要信封
• 除非提供 summaryArtifactPath，否则无需写入制品

托管制品路径格式：

• .hex-skills/runtime-artifacts/runs/{parent_run_id}/story-plan-worker/ln-222--{identifier}.json

输出契约

始终构建结构化摘要信封：

• schema_version
• summary_kind=story-plan-worker
• run_id
• identifier
• producer_skill=ln-222
• 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 摘要写入该路径

如果未提供 summaryArtifactPath：

• 仅在结构化输出中返回相同的摘要

工作流

1. 如果尚未提供 Epic 上下文，则解析该上下文。
2. 逐个加载现有 Story。
3. 标准化理想 Story 和现有 Story 的结构。
4. 运行重新规划算法，将其分类为 KEEP、UPDATE、OBSOLETE、CREATE。
5. 除非 autoApprove=true，否则显示操作摘要。
6. 执行特定于提供方的更新。
7. 更新 kanban。
8. 返回结构化摘要。

关键规则

• 匹配存在歧义时，优先采取保守更新。
• 重新规划与已完成的 Story 冲突时，保留已完成的工作。
• 保持 Worker 可独立运行。
• 运行时绝不依赖协调器状态。
• 返回机器可读结果，而不只是纯文本结果。
• 在调用 tracker createStory/updateBody 前停止： 验证正文中是否包含全部 9 个章节：Story、Context、Acceptance Criteria、Implementation Tasks、Test Strategy、Technical Notes、Definition of Done、Dependencies、Assumptions。缺少这些章节时，PreToolUse 钩子会阻止创建。

完成定义

• 已加载并标准化现有 Story
• 已应用重新规划算法
• 已执行所需的更新、取消和创建操作
• 已更新 kanban
• 已返回结构化摘要
• 提供 summaryArtifactPath 时已写入摘要制品

---

版本： 3.0.0 最后更新： 2025-12-23