Project Add Items

Fandhe-AI/agent-cli-skills/skills/project-add-items

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

Markdown チェックリスト・YAML タスクリスト・要件定義書などからプロジェクトアイテムを一括作成する。タイトル・本文・Priority・Size をパースして `gh project item-create` + `item-edit` でフィールド設定。「要件書からアイテム作って」「タスクをプロジェクトに追加」「ロードマップを取り込んで」などで使用。

Instructions onlyProductivity & Workflow
AI-generated overview

Bulk-creates GitHub Project items from Markdown checklists, YAML task lists, or requirement documents.

What it does
Parses a source such as a Markdown checklist, YAML task list, URL, or inline text and extracts each item's title, body, priority, size, and category. It resolves project and field metadata, creates items with gh project item-create, then sets Priority, Size, and Status values with gh project item-edit. It finishes by listing the created items in a table and verifying them against the project item list.
When to use it
Use when you want to turn a requirements document, task list, or roadmap into GitHub Project items in bulk. Also suited to requests such as adding tasks to a project or importing a roadmap. It asks for confirmation before creating large batches of 20 or more items.},
Requirements
Requires the gh CLI installed and authenticated with project scope, an existing GitHub Project, jq for resolving field and option IDs, and network access to the GitHub API. Instructions only; no scripts are shipped.

project-add-items

要件定義書・タスクリスト・ロードマップなどのソースからプロジェクトアイテムを一括作成します。

前提条件

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

フロー

Step 1: ソースを特定する

ユーザーからアイテムのソースを取得:

  • ファイルパス(Markdown、YAML 等)
  • URL(GitHub Issue 一覧、Wiki ページ等)
  • インラインテキスト(ユーザーが直接入力)

Step 2: ソースを解析してアイテムを抽出する

ソース形式に応じて解析し、以下の情報を抽出:

  • タイトル
  • 本文・説明
  • 優先度(High / Medium / Low)
  • サイズ(XS / S / M / L / XL)
  • カテゴリ(セクション見出し等から)

対応ソース形式の例:

Markdown チェックリスト:

markdown
## 認証機能- [ ] ソーシャルログイン実装 (Priority: High, Size: L)- [ ] パスワードリセット (Priority: Medium, Size: M)
## ダッシュボード- [ ] 利用統計グラフ (Priority: Low, Size: S)

YAML タスクリスト:

yaml
tasks:  - title: "ソーシャルログイン実装"    priority: High    size: L    description: "OAuth2 を使用した Google/GitHub ログイン"

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

bash
# プロジェクト ID を取得gh project view <number> --owner <owner> --format json -q '.id'
# フィールド ID とオプション ID を取得gh project field-list <number> --owner <owner> --format json

jq でフィールド名→フィールド ID、オプション名→オプション ID を解決する。

Step 4: アイテムを一括作成する

抽出した各アイテムに対して:

bash
gh project item-create <number> \  --owner <owner> \  --title "<タイトル>" \  --body "<本文>" \  --format json

出力からアイテム ID を取得する。

Step 5: フィールド値を設定する

各アイテムに対してフィールド値を設定:

bash
# Priority を設定gh project item-edit \  --id <item-id> \  --field-id <priority-field-id> \  --project-id <project-id> \  --single-select-option-id <option-id>
# Size を設定gh project item-edit \  --id <item-id> \  --field-id <size-field-id> \  --project-id <project-id> \  --single-select-option-id <option-id>
# Status を設定(デフォルト: Todo)gh project item-edit \  --id <item-id> \  --field-id <status-field-id> \  --project-id <project-id> \  --single-select-option-id <todo-option-id>

Step 6: 作成結果を一覧表示する

作成されたアイテムの一覧を表示:

#タイトルPrioritySizeStatus
1ソーシャルログイン実装HighLTodo
2パスワードリセットMediumMTodo

注意事項

  • 大量のアイテム(20件以上)を作成する場合は、ユーザーに確認してからバッチ実行する
  • ソースの形式が不明な場合はユーザーに確認する
  • フィールド値がプロジェクトのオプションに一致しない場合はスキップして警告する
  • GitHub API レート制限に注意し、必要に応じてバッチサイズを調整する
  • ネットワークを要する(主に API 経由。後述の「sandbox 環境での実行」節を参照)

検証

Step 6 完了後、以下で作成済みアイテムを確認する:

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

作成したタイトルが一覧に含まれ、Priority / Size / Status が期待値と一致すれば完了。

sandbox 環境での実行

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

Source and attribution

Source:Fandhe-AI/agent-cli-skillsinskills/project-add-itemsat commitb8c1f36

License: No license

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

Report or request removal