Project Archive Done

Fandhe-AI/agent-cli-skills/skills/project-archive-done

by Fandhe-AIb8c1f3669cc3eff5079b57ae6da56a42d395e94cNo license2 starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated today

Status が Done のプロジェクトアイテムを `gh project item-archive` で一括アーカイブする。Auto-archive ビルトインワークフローの設定状況も確認・案内 (有効なら手動実行は基本不要)。「完了アイテムをアーカイブ」「Done を整理」「ボード掃除」などで使用。

Instructions onlyProductivity & Workflow
AI-generated overview

Archives GitHub Project items with Done status using the gh CLI and checks the Auto-archive workflow setting.

What it does
This skill walks an agent through archiving completed (Done) items in a GitHub Project so the board stays tidy. It checks whether the built-in Auto-archive workflow is enabled, lists project items and field metadata, filters items whose Status is Done, shows the list for user confirmation, then archives each item with gh project item-archive. It finishes with a result report and a verification listing, and notes that archiving is reversible.
When to use it
Use it when a GitHub Project board has accumulated Done items and you want to archive them in bulk. It also fits requests to clean up a board or check whether Auto-archive is already handling this automatically.
Requirements
Requires the GitHub CLI (gh) installed and authenticated with the project scope, plus network access to GitHub; the skill is instructions only and ships no scripts. Archiving commands must run with the sandbox disabled per command, so environments that cannot lift network restrictions cannot run it.

project-archive-done

プロジェクト内の完了済み(Done)アイテムをアーカイブし、ボードを整理します。ビルトインの Auto-archive が設定済みの場合はその状況も確認します。

前提条件

  • 対象の GitHub Project に完了アイテムが存在すること
  • gh CLI がインストールされ、認証済みであること(project スコープ付き)

フロー

Step 1: Auto-archive の状況を確認する

ビルトインの Auto-archive ワークフローが有効な場合は自動でアーカイブされる。設定状況をユーザーに確認する。

設定 URL: https://github.com/orgs/<owner>/projects/<number>/workflows (個人プロジェクトの場合: https://github.com/users/<owner>/projects/<number>/workflows)

  • Auto-archive が有効 → 基本的にスキルの実行は不要。即時アーカイブしたい場合のみ続行
  • Auto-archive が無効 → このスキルで手動アーカイブを実行。必要に応じて Auto-archive の有効化も案内

Step 2: プロジェクトアイテムを取得する

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

Step 3: フィールドメタデータを取得する

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

Status フィールドの ID と "Done" オプションの ID を特定する。

Step 4: 完了アイテムをフィルタする

Step 2 の結果から、Status が "Done" のアイテムを抽出する。

--query が使える場合:

bash
gh project item-list <number> \  --owner <owner> \  --query "status:Done" \  --format json

Step 5: ユーザーに確認する

アーカイブ対象を表示:

以下の N 件の完了アイテムをアーカイブします:- #42: feat: ソーシャルログイン(Done)- #43: fix: バリデーションエラー(Done)- #44: docs: API ドキュメント更新(Done)
実行しますか?

Step 6: アーカイブを実行する

各アイテムをアーカイブ:

bash
gh project item-archive <number> \  --owner <owner> \  --id <item-id>

Step 7: 結果を報告する

## アーカイブ結果
- アーカイブ済み: N 件- 残りアクティブアイテム: M 件- ボード上の完了アイテム: 0 件

Auto-archive が無効の場合は有効化を推奨:

推奨: Auto-archive を有効にすると、Done から N 日経過したアイテムが自動でアーカイブされます。設定: <workflows URL>

検証

Step 7 完了後、以下でアーカイブ結果を確認する:

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

Status が "Done" のアイテムが一覧から消えていれば完了。アーカイブ済みアイテムは削除されておらず、元に戻せる(gh project item-archive --undo)。

注意事項

  • アーカイブ前に必ずユーザーの確認を得る
  • アーカイブは元に戻せる(gh project item-archive --undo)
  • アーカイブされたアイテムはプロジェクトビューから非表示になるが、削除はされない
  • Auto-archive ビルトインワークフローとの併用で手動実行の頻度を減らせる
  • 特定の条件(日付範囲、ラベル等)でフィルタしてアーカイブすることも可能

sandbox 環境での実行

このスキルはネットワーク越しの GitHub 操作(gh project item-archive)を必須とする。該当コマンドはコマンド単位で sandbox 無効にして実行する。ネットワーク遮断を解除できない環境では実行できない。

Source and attribution

Source:Fandhe-AI/agent-cli-skillsinskills/project-archive-doneat commitb8c1f36

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal