mcpField
L
ln-221-story-creator

ln-221-story-creator

github.com/levnikolaevich開発584371 回インストール2 日前に更新
リポジトリ

ln-221-story-creator について

Epic、テンプレート、設定済みのタスクトラッカーを使って Story を計画・作成する、単独実行可能なスキルです。INVEST と受け入れ条件の上限を検証し、構造化サマリーを返します。

主な機能

  1. 01Epic コンテキストの解決とテンプレート読み込み
  2. 02Story の生成と検証
  3. 03INVEST と受け入れ条件上限の確認
  4. 04Story 作成とカンバン更新
  5. 05構造化サマリーの出力

活用シーン

  1. 01Epic の 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-*)は、このスキルディレクトリからの相対パスです。

ストーリー作成者

タイプ: L3 ワーカー
カテゴリ: 2XX プランニング

ストーリー作成に特化した、単独実行を優先するワーカーです。直接呼び出す場合も、コーディネーターのフローの一部として呼び出す場合も、公開契約は同じです。

必ず読むこと

実行前に、以下を読み込んでください。

  • 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 が提供されない場合でも、ワーカーは完全に使用可能でなければなりません。単独実行モードでは、サマリーエンベロープを出力する前に独自の 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. ストーリーテンプレートを読み込みます。
  3. テンプレートのセクションに厳密に従ってストーリードキュメントを生成します。
  4. 標準に関する調査内容は、技術メモのみに挿入します。
  5. 作成前に INVEST と AC の上限を検証します。
  6. autoApprove=true でない限り、プレビューを表示します。
  7. 設定されたトラッカープロバイダーを通じてストーリーを作成します。
  8. カンバンを更新します。
  9. story-plan-worker サマリーを書き込みます。
  10. 構造化サマリーを返します。

重要なルール

  • テンプレートで定義されたストーリー構造を厳密に維持します。
  • 標準に関する調査内容は技術メモに挿入し、ACには挿入しません。
  • INVEST に違反するストーリーや、AC の上限を超えるストーリーは却下します。
  • トラッカーの createStory を呼び出す前に停止してください: 本文に9つのセクション(Story、Context、Acceptance Criteria、Implementation Tasks、Test Strategy、Technical Notes、Definition of Done、Dependencies、Assumptions)がすべて含まれていることを確認します。これらが揃っていない場合、PreToolUse フックが作成をブロックします。
  • 単独で実行できる状態を維持します。
  • 動作にコーディネーターのランタイム状態を必要としてはなりません。

完了の定義

  • ストーリーテンプレートを読み込み、その内容に従っている
  • ストーリードキュメントを生成している
  • INVEST の検証に合格している
  • プロバイダー固有のストレージにストーリーを作成している
  • カンバンを更新している
  • 構造化サマリーを返している
  • summaryArtifactPath が指定されている場合、サマリーアーティファクトを書き込んでいる

バージョン: 3.0.0 最終更新日: 2025-12-23

コメント