mcpField
L
ln-222-story-replanner

ln-222-story-replanner

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

ln-222-story-replanner について

Epic のストーリーを再計画する、単独実行可能なワーカー用スキルです。理想の計画と既存のストーリーを比較して変更を分類・適用し、カンバンを更新して構造化サマリーを返します。

主な機能

  1. 01理想の計画と既存ストーリーの比較
  2. 02維持・更新・廃止・作成の分類
  3. 03確認または自動承認
  4. 04ストーリーとカンバンの更新
  5. 05構造化サマリーの返却

活用シーン

  1. 01Epic の変更後のストーリー再計画
  2. 02再計画時の完了済み作業の保持
  3. 03単独または管理下の子ワーカーとして実行

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/ln-222-story-replannerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
agent_skill_roots_contract.md
coordinator_summary_contract.md
environment_state_contract.md
planning_worker_runtime_contract.md
replan_algorithm_stories.md
replan_algorithm.md
replan_workflow.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/template_loading_pattern.md
  • references/replan_algorithm_stories.md

入力

必須入力:

  • epicData
  • idealPlan
  • existingStoryIds
  • 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_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 が指定されていない限り、アーティファクトの書き込みは任意です

出力コントラクト

常に構造化サマリーエンベロープを作成します。

  • schema_version
  • summary_kind=story-plan-worker
  • run_id
  • identifier
  • producer_skill=ln-222
  • produced_at
  • payload

ペイロードのフィールド:

  • mode
  • epic_id
  • stories_planned
  • stories_created
  • stories_updated
  • stories_canceled
  • story_urls
  • warnings
  • kanban_updated
  • research_path_used

summaryArtifactPath が指定されている場合:

  • 同じ JSON サマリーをそのパスに書き込みます

summaryArtifactPath が指定されていない場合:

  • 同じサマリーを構造化出力のみで返します

管理対象アーティファクトのパスパターン:

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

ワークフロー

  1. まだ提供されていない場合、Epic のコンテキストを解決します。
  2. 既存のストーリーを1件ずつ読み込みます。
  3. 理想と既存のストーリー構造を正規化します。
  4. 再計画アルゴリズムを実行し、KEEP、UPDATE、OBSOLETE、CREATE に分類します。
  5. autoApprove=true でない場合、操作の概要を表示します。
  6. プロバイダー固有の更新を実行します。
  7. カンバンを更新します。
  8. 構造化サマリーを返します。

重要なルール

  • マッチングが曖昧な場合は、保守的な更新を優先してください。
  • 再計画が完了済みのストーリーと競合する場合は、完了した作業を保持してください。
  • ワーカーをスタンドアロンで使用できる状態にしてください。
  • 動作にコーディネーターのランタイム状態を決して要求しないでください。
  • 散文のみの結果ではなく、機械可読な結果を返してください。
  • トラッカーの createStory/updateBody を呼び出す前に停止してください: 本文に以下の9つのセクションがすべて存在することを確認してください:Story、Context、Acceptance Criteria、Implementation Tasks、Test Strategy、Technical Notes、Definition of Done、Dependencies、Assumptions。これらがない場合、PreToolUse フックによって作成がブロックされます。

完了の定義

  • 既存のストーリーを読み込み、正規化した
  • 再計画アルゴリズムを適用した
  • 必要な更新、キャンセル、作成を実行した
  • カンバンを更新した
  • 構造化サマリーを返した
  • summaryArtifactPath が指定されている場合、サマリーアーティファクトを書き込んだ

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

コメント