project-view-status

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

project-view-status

プロジェクトの進捗状況をステータス別・優先度別に集計し、レポートを生成します。

Aggregates project progress by status and priority to generate reports.

前提条件

Prerequisites

対象の GitHub Project が存在すること
```
gh
```
CLI がインストールされ、認証済みであること（
```
project
```
スコープ付き）

The target GitHub Project exists
The
```
gh
```
CLI is installed and authenticated (with the
```
project
```
scope)

フロー

Flow

Step 1: プロジェクト情報を取得する

Step 1: Retrieve project information

bash

gh project view <number> --owner <owner> --format json

プロジェクトのタイトル・説明・URL を取得する。

bash

gh project view <number> --owner <owner> --format json

Retrieves the project's title, description, and URL.

Step 2: 全アイテムを取得する

Step 2: Retrieve all items

bash

gh project item-list <number> \
  --owner <owner> \
  --limit 999 \
  --format json

bash

gh project item-list <number> \
  --owner <owner> \
  --limit 999 \
  --format json

Step 3: フィールド定義を取得する

Step 3: Retrieve field definitions

bash

gh project field-list <number> \
  --owner <owner> \
  --format json

Status, Priority, Size フィールドの定義とオプション値を取得する。

bash

gh project field-list <number> \
  --owner <owner> \
  --format json

Retrieves definitions and option values for Status, Priority, and Size fields.

Step 4: ステータス別・優先度別に集計する

Step 4: Aggregate by status and priority

JSON データを処理して以下を集計:

ステータス別アイテム数（Todo / In Progress / In Review / Done）
優先度別アイテム数（High / Medium / Low）
ステータス × 優先度のクロス集計
完了率（Done / 全件）

Processes JSON data to aggregate the following:

Number of items by status (Todo / In Progress / In Review / Done)
Number of items by priority (High / Medium / Low)
Cross-tabulation of Status × Priority
Completion rate (Done / Total items)

Step 5: レポートを生成する

Step 5: Generate report

以下の形式でレポートを出力:

markdown

undefined

Outputs the report in the following format:

markdown

undefined

プロジェクト進捗レポート: <タイトル>

Project Progress Report: <Title>

更新日時: YYYY-MM-DD HH:MM

Last Updated: YYYY-MM-DD HH:MM

全体進捗

Overall Progress

総アイテム数: N 件
完了率: XX% (N/M)
進行中: N 件
レビュー中: N 件
未着手: N 件

Total Items: N
Completion Rate: XX% (N/M)
In Progress: N
In Review: N
Not Started: N

ステータス別

By Status

ステータス	件数	割合
Done	N	XX%
In Review	N	XX%
In Progress	N	XX%
Todo	N	XX%

Status	Count	Percentage
Done	N	XX%
In Review	N	XX%
In Progress	N	XX%
Todo	N	XX%

優先度別（未完了のみ）

By Priority (Incomplete Only)

優先度	件数	In Progress	Todo
High	N	N	N
Medium	N	N	N
Low	N	N	N

Priority	Count	In Progress	Todo
High	N	N	N
Medium	N	N	N
Low	N	N	N

サイズ別（未完了のみ）

By Size (Incomplete Only)

サイズ	件数
XL	N
L	N
M	N
S	N
XS	N

undefined

Size	Count
XL	N
L	N
M	N
S	N
XS	N

undefined

注意事項

Notes

```
--limit 999
```
でページネーション切り捨てを防ぐ
読み取り専用の操作のため、プロジェクトに変更を加えない
フィールドが存在しない場合は該当セクションをスキップする
アイテムが 0 件の場合はその旨を報告する
sandbox 環境での
GIT_SSL_NO_VERIFY=1
併用：詳細は後述の「sandbox 環境での実行」節を参照

Use
```
--limit 999
```
to prevent pagination truncation
This is a read-only operation, so no changes are made to the project
Skip the corresponding section if the field does not exist
Report if there are 0 items
Use
GIT_SSL_NO_VERIFY=1
in sandbox environment: Refer to the "Execution in Sandbox Environment" section below for details

sandbox 環境での実行

Execution in Sandbox Environment

sandbox で本スキルを実行する場合、ネットワーク越しの GitHub 操作には

GIT_SSL_NO_VERIFY=1

の併用を検討してください。本スキルの主なリモート操作は

gh project item-list

で、「リモート書き込み」判定は 要（本スキルは read-only） です。コマンド分類の詳細と TLS 検証無効化の注意事項は

docs/sandbox-tls.md

を参照してください。

When running this skill in a sandbox, consider using

GIT_SSL_NO_VERIFY=1

for GitHub operations over the network. The main remote operation of this skill is

gh project item-list

, and the "remote write" determination is Required (this skill is read-only). For details on command classification and notes on disabling TLS verification, refer to

docs/sandbox-tls.md