agile-story

ストーリー

明確で、そのまま実装に着手できる実行計画を作成するために、このスキルを使用します。

スラッシュコマンド経由で受け取った初期コンテキスト：$ARGUMENTS

$ARGUMENTS に内容が入力されている場合（例：ストーリーの参照、説明、課題）は、それを出発点として使用します。 空の場合は、何を計画するか尋ねます。

言語

成果物はユーザーの言語で記述します。文法を正しく使い、必要な発音区別符号や各文字体系固有の文字も適切に使用します。ユーザーの言語が明確でない場合は、出力を生成する前に確認します。テンプレートは英語で記述されています。見出しと内容を、ユーザーの言語に合わせて翻訳します。

プロジェクトルート

このスキルが成果物を作成するパスは、エージェントの現在の作業ディレクトリではなく、プロジェクトルート（作業を行うリポジトリ）からの相対パスです。

• プロジェクト内から実行する場合は、このスキルに記載されている相対パスを使用します。
• 別のディレクトリから実行する場合（例：隣接するリポジトリ、またはプロジェクトが別の場所にある場合）は、すべての成果物パスの先頭に<project-root>/を付けます。
• プロジェクトルートが曖昧な場合は、書き込みを行う前にハーネスの質問ツールを使ってユーザーに確認します。

プロンプトの作成

プロジェクト全体の規約であるCLAUDE.md / AGENTS.md（「Skill Prompting Conventions」）に従います。以下の判断ポイントでは、ハーネスの構造化質問ツール（Claude Codeの場合はAskUserQuestion、Codexの場合はask_user_question、OpenCodeの場合はquestion）を使用します。

判断ポイント	構造化質問を使用する理由	推奨される選択肢
実装モード	終了時のフローが分岐するため	計画のみ（成果物の作成後に終了） · 計画してから実装（このセッションで続行）
テスト戦略（関連テストを追加する場合）	ファイル配置に影響するため	sibling · sibling_dir · tests_root

自由形式のプロンプト（構造化ツールは使用しません）：

• ストーリー名
• タスクの説明
• 技術スタックの選択（エピックの段階でまだ決まっていない場合）

一時停止なしモード：ユーザーがスキル実行中の確認を明示的に無効にしている場合は、構造化プロンプトをすべて「未解決の質問」（または同等の項目）に記載し、処理を止めずに進めます。

目的

• 明確で、規模に見合ったシンプルな実行計画を作成する
• 影響を受けるファイルを特定する
• 検証可能なタスクを定義する
• すぐに実装に着手できる成果物を作成する

使用する場面

• 小規模かつ局所的な作業（ファイル数が少なく、リスクが低く、単一サイクルで完了するもの）
• エピック内のストーリーに、実務で使える実行計画が必要な場合
• エピックですでに詳細化されているストーリーについて、タスクとファイルの対応付けが必要な場合
• 問題がすでに明確で、変更内容を整理するだけでよい場合

使用しない場面

• 作業規模が大きく、さらに分解する必要がある場合は、/agile-epicを使用します
• 問題がまだ明確でない場合は、/agile-intakeを使用します
• 複数の依存する納品物がある場合は、/agile-epicを使用します
• 戦略的な方向性が必要な場合は、/agile-roadmapを使用します

プロセス

1. 実施内容を理解する

エピックのストーリーファイルから始める場合は、そのストーリーを読み、以下を抽出します。

• 目的
• 影響を受けるファイル
• 受け入れ基準
• 関連するプロトタイプのルート／画面
• 関連するビジネスルールのID／ファイル

単独で進める場合は、ユーザーに確認し、コードを調査してコンテキストを把握します。

2. 計画を作成する

以下の必須セクションを埋めます。

• コンテキスト： 問題、目的、制約
• トレーサビリティ： プロトタイプのルート／画面、ビジネスルールのID／ファイル、参照ドキュメント
• ファイル： 操作（読み取り／変更／作成）を記載した正確なパス
• 詳細： 現状（AS-IS）、変更後（TO-BE）、対象範囲、アプローチ
• テストファースト計画： 検証する動作、最初に失敗させるテスト、テストレベル、避けるべき価値の低いテスト
• タスク： 検証可能なチェックリスト
• 検証： コマンドと検証項目

3. 提示して確認を待つ

ハーネスの計画モードツールを使って計画を提示します（例：Claude Code の ExitPlanMode）。実装を始める前に、明示的な確認を待ちます。

実装モード（このステップで決定）：

• 計画してから実装（同じセッション）： 計画を提示し、確認を得てから、チェックリストに従ってコードを書きます。コード変更が続くことを想定した「ストーリー」をユーザーが依頼した場合のデフォルトです。
• 計画のみ： 計画の成果物を保存したら終了します。実行前にエピックを分割する場合や、このスキルをサンプル演習として実行する場合など、ストーリーが計画サイクルに属する場合のデフォルトです。

ワークフローが曖昧な場合は、ハーネスの質問ツールを使ってユーザーにモードを確認します（「## プロンプト」を参照）。

エピックとストーリーの境界

ストーリーファイルがすでに /agile-epic によって作成されている場合、このスキルは実行の詳細を追加し、エピック作成時の内容を書き換えません。

• エピック作成時には、Tasks に垂直フェーズの概要を記載します。
• ストーリー作成時には、タスクごとの Done when: 基準、Test-first plan、具体的な検証コマンドを追加します。
• ストーリー作成時には、実装上の選択肢を2つ以上確定する必要がある場合、Approach 内に Story-time decisions テーブルを追加してもかまいません。

保存先

• イニシアチブの一部の場合：planning/<initiative>/epics/NN-<epic>/NN-story-name.md
  • エピックですでにストーリーファイルが作成されている場合は、そのファイルの Tasks セクションと Verification セクションを追加・更新します。
• 単独の場合：.agents/plans/<name>.md（エピックに属さない項目の場合）

タスク計画は実行の成果物です。Origin フィールドを通じて、親となるストーリーまたはエピックを参照します。イニシアチブの一部である場合、ストーリーファイルにすでにコンテキストが記載されているため、タスクでは実行の詳細を追加します。

相互参照

計画がエピックに由来する場合は、先頭に次を含めます。

**Origin:** `planning/<initiative>/epics/NN-<epic>/00-overview.md`

次のステップ

計画の確認後：

• 計画してから実装： チェックリストに従って実装し、最後に /agile-status（クローズモード）を提案してデリバリーを完了します。
• 計画のみ： 計画の成果物を作成したら終了し、実装が実際に行われる際にこのスキルを再度呼び出す（または /agile-status でクローズする）よう提案します。

参照テンプレート

このスキルの templates/story.md をベースとして使用します。

必須セクション

すべての計画に次の内容を含めます。

1. Context（問題、目的、制約、参照情報）
2. Traceability（プロトタイプのルート／画面、ビジネスルールの ID／ファイル、参照ドキュメント）
3. Files（正確なパス、操作、理由）
4. Detail（AS-IS、TO-BE、スコープ、アプローチ、リスク）
5. Test-first plan（動作、最初に失敗するテスト、推奨レベル、該当する場合はフロントエンドの価値確認）
6. Tasks（検証可能なチェックリスト）
7. Verification（lint、typecheck、テスト、手動検証、受け入れ確認）

ルール

• すべての計画は、実装前に提示する必要があります（ExitPlanMode）。
• ユーザーから明示的な確認を得た後にのみ実装します。
• エピックが必要な作業（複数のストーリーを伴う大規模なスコープ）には、タスク計画を作成しません。
• ファイルには正確なパスを記載します。
• ストーリーでドメイン動作、権限、同期、競合処理、AI の承認、または監査／バージョン管理を実装する場合は、ビジネスルールの ID を参照します。
• フロントエンドの計画では、ユーザー向けの変更がある場合、プロトタイプのルート／画面を明記します。
• タスクは検証可能な内容にし、曖昧な表現を避けます。
• 完了した項目は、実際の進捗に応じて [ ] を [x] に更新します。

フローとの関係

flowchart LR
    A["/agile-intake"] --> B["/agile-epic"]
    B --> C["/agile-story"]
    C --> D[execution]
    D --> E["/agile-status"]
    E --> F["/agile-retro"]

このスキルは、実行前の最終ステップです。より大規模な問題には /agile-epic を使用します。デリバリーを完了するには、/agile-status（クローズモード）を使用します。