project-archive-done

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

project-archive-done

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

Archive completed (Done) items in the project to organize the board. Also checks the status if the built-in Auto-archive is configured.

前提条件

Prerequisites

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

Completed items exist in the target GitHub Project
The
```
gh
```
CLI is installed and authenticated (with the
```
project
```
scope)

フロー

Flow

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

Step 1: Check Auto-archive status

ビルトインの 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 の有効化も案内

If the built-in Auto-archive workflow is enabled, items will be archived automatically. Confirm the configuration status with the user.

Configuration URL:

https://github.com/orgs/<owner>/projects/<number>/workflows

(For personal projects:

https://github.com/users/<owner>/projects/<number>/workflows

)

Auto-archive enabled → Execution of this skill is basically unnecessary. Continue only if you want to archive immediately
Auto-archive disabled → Perform manual archiving with this skill. Guide users to enable Auto-archive if needed

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

Step 2: Retrieve project items

bash

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

bash

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

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

Step 3: Retrieve field metadata

bash

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

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

bash

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

Identify the ID of the Status field and the ID of the "Done" option.

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

Step 4: Filter completed items

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

--query

が使える場合:

bash

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

Extract items with Status set to "Done" from the results of Step 2.

--query

is available:

bash

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

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

Step 5: Confirm with the user

アーカイブ対象を表示:

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

実行しますか？

Display items to be archived:

The following N completed items will be archived:
- #42: feat: Social Login (Done)
- #43: fix: Validation Error (Done)
- #44: docs: API Documentation Update (Done)

Do you want to proceed?

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

Step 6: Execute archiving

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

bash

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

Archive each item:

bash

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

Step 7: 結果を報告する

Step 7: Report results

undefined

undefined

アーカイブ結果

Archiving Results

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


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

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

undefined

Archived: N items
Remaining active items: M items
Completed items on board: 0 items


If Auto-archive is disabled, recommend enabling it:

💡 Enabling Auto-archive will automatically archive items N days after they are marked Done. Configuration: <workflows URL>

undefined

注意事項

Notes

アーカイブ前に必ずユーザーの確認を得る
アーカイブは元に戻せる（
```
gh project item-archive --undo
```
）
アーカイブされたアイテムはプロジェクトビューから非表示になるが、削除はされない
Auto-archive ビルトインワークフローとの併用で手動実行の頻度を減らせる
特定の条件（日付範囲、ラベル等）でフィルタしてアーカイブすることも可能
sandbox 環境での
GIT_SSL_NO_VERIFY=1
併用：詳細は後述の「sandbox 環境での実行」節を参照

Always obtain user confirmation before archiving
Archiving can be undone (
```
gh project item-archive --undo
```
)
Archived items are hidden from the project view but not deleted
Using together with the Auto-archive built-in workflow reduces the frequency of manual execution
It is also possible to filter and archive items based on specific conditions (date range, labels, etc.)
Using
GIT_SSL_NO_VERIFY=1
in sandbox environments: Refer to the "Execution in sandbox environments" section below for details

sandbox 環境での実行

Execution in sandbox environments

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

GIT_SSL_NO_VERIFY=1

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

gh project item-archive

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

docs/sandbox-tls.md

を参照してください。

When running this skill in a sandbox environment, consider using

GIT_SSL_NO_VERIFY=1

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

gh project item-archive

, and the "remote write" determination is Required (this skill mainly uses APIs). For details on command classification and precautions for disabling TLS verification, refer to

docs/sandbox-tls.md