mcpField
A
agile-status

agile-status

github.com/djalmajr生産性4120 回インストール5 週間前に更新
リポジトリ

agile-status について

agile-statusは、チェックポイント、期間サマリー、正式な完了記録を通じて進捗を追跡するスキルです。ブロッカーやリスク、検証、次の作業を整理し、計画や課題との追跡可能性を保ちます。

主な機能

  1. 01進捗、ブロッカー、次の作業の記録
  2. 02成果、差異、リスクの期間別集約
  3. 03完了、検証、引き継ぎの記録
  4. 04計画や課題との追跡可能性の維持

活用シーン

  1. 01日次または作業途中のチェックポイント記録
  2. 02週次やマイルストーンの状況報告作成
  3. 03ストーリーやエピック完了時の成果と検証の確認

インストール

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

$npx skills add https://github.com/djalmajr/skills --skill agile-status

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

同梱ファイルtemplates/status.md

詳細

状況

このスキルを使って、進捗状況を追跡します。ユーザーのニーズに応じて、簡単なチェックポイント、期間ごとの取りまとめ、または納品の完了処理に対応します。

スラッシュコマンドから受け取った初期コンテキスト:$ARGUMENTS

$ARGUMENTS に値が含まれている場合(例:施策名、課題、計画の参照、"daily"、"report"、"close")、それを起点として使用します。 空の場合は、チェックポイント、取りまとめ、完了処理のどれが必要かをユーザーに確認します。

言語

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

プロジェクトルート

このスキルは、エージェントの現在の作業ディレクトリではなく、プロジェクトルート(作業対象のリポジトリ)からの相対パスに成果物を書き込みます。

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

プロンプトの作成

CLAUDE.md/AGENTS.md のプロジェクト全体の規約(「スキルのプロンプト作成規約」)に従ってください。以下の判断が必要な箇所では、ハーネスの構造化質問ツール(Claude Code のAskUserQuestion、Codex のask_user_question、または OpenCode のquestion)を使用します。

判断が必要な箇所構造化する理由推奨される選択肢
モードテンプレートとフローを選択するためチェックポイント · 取りまとめ · 完了処理
次のステップへの連携(ストーリーごとの完了処理)次のアクションを分岐させるため次の/agile-story · 後で取りまとめ · なし
次のステップへの連携(サイクル終了時の完了処理)次のアクションを分岐させるため/agile-review · /agile-retro

自由記述のプロンプト(構造化質問ツールを使わないもの):

  • ブロッカーの説明
  • 進捗の説明

一時停止なしモード:ユーザーがスキル実行中の確認を明示的に無効にしている場合は、構造化質問による各確認事項を「未解決の質問」(または同等の項目)に記載し、処理を止めずに続行します。

目的

  • 計画、ストーリー、エピックに対する実際の進捗を追跡する
  • ブロッカーの影響、担当者、次のアクションを明確にする
  • 期間内の納品内容、逸脱、リスクを取りまとめる
  • 検証と引き継ぎを行い、納品を正式に完了する
  • 進行中の計画や課題とのトレーサビリティを維持する

モード

チェックポイント(旧/daily)

簡潔な状況更新です。進捗、ブロッカー、次のステップを記録します。所要時間は5分未満です。

使用する場面:

  • 日次またはセッション単位の進捗更新
  • ブロッカーが発生し、明確にする必要がある場合
  • 作業途中のチェックポイント

手順:

  1. 進行中の計画、ストーリー、または課題を特定します。
  2. 前回のサイクルから進展した内容を記録します。
  3. ブロッカーの影響、担当者、次のアクションを記録します。
  4. 次に実施する、観測可能なステップを定義します。

保存先:

  • デフォルトではインラインで提示します(チェックポイントは短いため)。
  • ユーザーから保存を依頼された場合:planning/<initiative>/status/YYYY-MM-DD.md
取りまとめ(旧/status-report)

期間またはマイルストーンの概要です。完了事項、逸脱、リスク、必要な意思決定をまとめます。

使用する場面:

  • 関係者から施策の進捗を尋ねられた場合
  • エピックまたはスプリントの途中で、進捗をまとめて確認する場合
  • 週次または隔週の状況報告
  • スプリントレビュー前に、状況のスナップショットを作成する場合

手順:

  1. レポートの範囲(期間、マイルストーン、施策)を定めます。
  2. チェックポイント、計画、エピック/ストーリー、Git ログから情報を収集します。
  3. 完了事項、進行中の作業、逸脱、リスク、必要な意思決定をまとめます。
  4. 担当者を含めて次のステップを定義します。

保存先:

  • planning/<initiative>/status/report-YYYY-MM-DD.md
  • または、短いレポートの場合はインラインで提示します
クローズ(旧 /post-impl)

正式なデリバリーのクローズです。計画と結果、検証、残るリスク、引き継ぎを記録します。

使用するタイミング:

  • 計画、ストーリー、エピックが完了したとき
  • 次のデリバリーに進む前
  • 振り返りの前に、客観的な記録を作成するとき

プロセス:

  1. クローズするデリバリー(計画、ストーリー、エピック)を特定します。
  2. ドラフト作成前にスコープの逸脱を明らかにします。 ストーリーの受け入れ条件と照らし合わせて git diff(または同等のもの)を実行します。受け入れ条件の各項目に該当しない変更を、変更ごとの理由とともに明記します。これにより、後からではなく、記録の作成時に逸脱を検出できます。
  3. 計画と結果を比較します。提供したもの、保留となったもの、スコープの変更を記録します。
  4. lint、型チェック、テスト、手動検証を実行し、実際の結果を記録します。
  5. 残るリスクと次のステップを記録します。
  6. 引き継ぎ先(誰に知らせる必要があるか)を明確にします。

クローズの範囲(後続のフローに影響します):

  • ストーリー単位のクローズ — 進行中のエピックまたはスプリント内で、単一のストーリーが完了した場合です。/agile-retro は実行せず、次の /agile-story または後日の統合を推奨します。
  • サイクル終了時のクローズ — エピックが完了した、スプリントが終了した、またはイニシアチブが完了した場合です。/agile-review(デモとメトリクス)、続いて /agile-retro を推奨します。

保存先:

  • planning/<initiative>/status/<mode>-YYYY-MM-DD-<slug>.md — <slug> によって、同じ日の複数のクローズを区別します(例:closure-2026-05-12-story-01.md)。
  • 単独の計画の場合:内容をそのまま提示します

モードの選び方

  • 簡単なチェックポイントが必要ですか? → チェックポイントモード
  • 期間またはマイルストーンをまとめる必要がありますか? → 統合モード
  • デリバリーが完了し、クローズが必要ですか? → クローズモード
  • 判断できませんか? ユーザーに状況を尋ね、適切なモードを提案します。

次のフローへの移行

  • チェックポイント:重大なブロッカーがある場合は、エスカレーションするか計画を調整します。デリバリーをクローズする場合は、クローズモードに切り替えます。
  • 統合:期間の終了に伴ってデリバリーをクローズした場合は、クローズモードを提案します。スプリントが終了した場合は、/agile-review または /agile-retro を提案します。
  • クローズ(ストーリー単位):次の /agile-story または後日の統合を提案します。単一のストーリーに対して /agile-retro は実行しません。
  • クローズ(サイクル終了時):/agile-review、続いて /agile-retro を提案します。エピックの一部である場合は、エピックの概要にあるストーリーのステータスも更新します。

参考テンプレート

このスキルに含まれる templates/status.md をベースとして使用します。

ルール

  • 更新内容には、楽観的な見込みではなく、実際の状態を必ず反映します。
  • ブロッカーには、説明だけでなく、影響、担当者、次のアクションを記載します。
  • トレーサビリティを確保するため、チェックポイントでは具体的な計画、ストーリー、または課題を参照します。
  • クローズモードでは、必ず lint、型チェック、テストを実行します。成功したと決めつけてはいけません。
  • 意図ではなく、実際の結果を報告します。lint に失敗した場合は、失敗したと記載します。
  • 内容は適切な分量に保ちます。チェックポイントは5分以内、統合は15分以内で完了させます。

フローとの関係

flowchart LR
    A["/agile-story"] --> B[execution]
    B --> C["/agile-status<br>(checkpoint)"]
    C --> D["/agile-status<br>(consolidation)"]
    D --> E["/agile-status<br>(closure)"]
    E --> F["/agile-retro"]

このスキルは、すべてのデリバリー追跡を扱います。計画には /agile-intake、/agile-epic、または /agile-story を使用します。セレモニーには /agile-sprint、/agile-review、または /agile-retro を使用します。

コメント