project-view-status
プロジェクトの進捗をステータス別・優先度別・サイズ別に集計してレポートを生成する。完了率と未完了の優先度内訳を表形式で出力する読み取り専用スキル。「進捗を見せて」「プロジェクトレポート」「完了率は?」「ステータス別の件数」などで使用。
By fandhe-ai · 486 installs
npx skills add fandhe-ai/agent-cli-skills --skill project-view-status
Source repository · Upstream listing
project view status
プロジェクトの進捗状況をステータス別・優先度別に集計し、レポートを生成します。
前提条件
対象の GitHub Project が存在すること
gh CLI がインストールされ、認証済みであること( project スコープ付き)
フロー
Step 1: プロジェクト情報を取得する
プロジェクトのタイトル・説明・URL を取得する。
Step 2: 全アイテムを取得する
Step 3: フィールド定義を取得する
Status, Priority, Size フィールドの定義とオプション値を取得する。
Step 4: ステータス別・優先度別に集計する
JSON データを処理して以下を集計:
ステータス別アイテム数(Todo / In Progress / In Review / Done)
優先度別アイテム数(High / Medium / Low)
ステータス × 優先度のクロス集計
完了率(Done / 全件)
Step 5: レポートを生成する
以下の形式でレポートを出力:
注意事項
limit 999 でページネーション切り捨てを防ぐ
読み取り専用の操作のため、プロジェクトに変更を加えない
フィールドが存在しない場合は該当セクションをスキップする
アイテムが 0 件の場合はその旨を報告する
ネットワークを要する(読み取りのみ。後述の「sandbox 環境での実行」節を参照)
検証
Step 5 のレポート出力に以下が含まれていれば完了:
総アイテム数・完了率が表示されている
ステータス別・優先度別の件数が集計されている
プロジェクトに変更は加わらない(読み取り専用)。
sandbox 環境での実行
Step 1〜3 の gh project view / gh project item list / gh project field list はいずれも GitHub API への読み取りであり、ネットワークを要する。該当コマンド単位で sandbox 無効にして実行する。本スキルは書き込みを一切行わない(プロジェクトへの変更なし・ワークスペース外への書き込みなし)。Step 4〜5 の集計・レポート生成はローカル処理であり、ネットワークを要しない。