mcpField
L
ln-221-story-creator

ln-221-story-creator

github.com/levnikolaevich开发584371 次安装3 天前更新
代码仓库

关于 ln-221-story-creator

可独立运行的技能，用于基于 Epic、模板和已配置的任务跟踪器规划并创建 Story。它会验证 INVEST 和验收标准限制，并返回结构化摘要。

主要功能

  1. 01解析 Epic 上下文并加载模板
  2. 02生成并验证 Story
  3. 03检查 INVEST 和验收标准限制
  4. 04创建 Story 并更新看板
  5. 05返回结构化摘要

适用场景

  1. 01为 Epic 规划 Story
  2. 02在跟踪器创建前验证 Story 内容
  3. 03将规划好的 Story 添加到已配置的跟踪器

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-221-story-creator

安装后在 Claude Code 中输入/ln-221-story-creator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
agent_skill_roots_contract.md
coordinator_summary_contract.md
creation_quality_checklist.md
environment_state_contract.md
planning_worker_runtime_contract.md
storage_mode_detection.md
template_loading_pattern.md
references/scripts/coordinator-runtime/lib/
artifacts.mjs
cli-helpers.mjs
core.mjs
loop-health.mjs
runtime-constants.mjs
schemas.mjs
validate.mjs
worker-guards.mjs
worker-runtime.mjs
references/scripts/planning-worker-runtime/
cli.mjs
references/scripts/planning-worker-runtime/lib/
guards.mjs
phases.mjs
store.mjs

详细介绍

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

Story 创建器

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

专用于创建 Story 的独立优先型 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

即使调用方未提供 runId 和 summaryArtifactPath，此 Worker 也必须保持完全可用。在独立模式下，它会在发出摘要信封前生成自己的 run_id。

运行时

运行时系列：planning-worker-runtime

标识符：

  • epic-{epicId}

阶段：

  1. PHASE_0_CONFIG
  2. PHASE_1_RESOLVE_CONTEXT
  3. PHASE_2_LOAD_TEMPLATE
  4. PHASE_3_GENERATE_STORIES
  5. PHASE_4_VALIDATE_STORIES
  6. PHASE_5_CONFIRM_OR_AUTOAPPROVE
  7. PHASE_6_APPLY_CREATE
  8. PHASE_7_UPDATE_KANBAN
  9. PHASE_8_WRITE_SUMMARY
  10. PHASE_9_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-221--{identifier}.json

工作流

  1. 如果尚未提供，则解析任务提供方和 Epic 上下文。
  2. 加载 Story 模板。
  3. 严格按照模板章节生成 Story 文档。
  4. 仅将标准研究内容插入 Technical Notes。
  5. 在创建前验证 INVEST 和 AC 限制。
  6. 除非 autoApprove=true，否则显示预览。
  7. 通过已配置的跟踪器提供方创建 Story。
  8. 更新看板。
  9. 写入 story-plan-worker 摘要。
  10. 返回结构化摘要。

关键规则

  • 严格遵循模板定义的 Story 结构。
  • 将标准研究内容插入 Technical Notes，而不是 AC。
  • 拒绝未通过 INVEST 验证或超出 AC 限制的 Story。
  • 在调用跟踪器的 createStory 前停止： 验证正文中是否包含全部 9 个章节：Story、Context、Acceptance Criteria、Implementation Tasks、Test Strategy、Technical Notes、Definition of Done、Dependencies、Assumptions。缺少这些章节时，PreToolUse 钩子会阻止创建。
  • 保持独立运行能力。
  • 运行时绝不依赖协调器状态。

完成标准

  • 已加载并遵循 Story 模板
  • 已生成 Story 文档
  • 已通过 INVEST 验证
  • 已在特定提供方的存储中创建 Story
  • 已更新看板
  • 已返回结构化摘要
  • 提供 summaryArtifactPath 时，已写入摘要构件

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

评论

支持 Markdown