gh-tasks は何をしますか?
GitHub CLI拡張機能兼スキルバンドル。GitHub Projects v2、Issue、マイルストーンを横断してタスクを管理します。個人のTODO、単一プロジェクト、複数プロジェクトの調整に対応。Claude Code、Codex CLI、GitHub Copilot、Gemini CLI向けに配布されています。
機能
- タスク管理:GitHub Projects v2のボードにタスクを作成、更新、クローズします。
- Issue連携:Issueとプロジェクト項目を双方向に同期します。
- マイルストーン:マイルストーンの作成と進捗追跡をサポートします。
- クロスプロジェクト:複数のリポジトリやOrganizationを横断したタスク調整を実現します。
- AI連携:Claude Code、Codex CLI、GitHub Copilot、Gemini CLIの各AIエージェントから呼び出せます。
インストール
GitHub CLI拡張機能として
github extension install ozzy-labs/gh-tasks
AIエージェントスキルとして
各AIツールの指示に従って、このリポジトリのスキル定義をインポートしてください。
使用例
新しいタスクを作成
gh tasks create --project "My Project" --title "ドキュメントを更新" --body "APIドキュメントの第3章を更新する"
タスクの一覧表示
gh tasks list --project "My Project" --status "進行中"
タスクのクローズ
gh tasks close --id 1234
マイルストーンにタスクを割り当て
git tasks assign --milestone "v2.0リリース" --task-id 1234
設定
このスキルは、認証にGitHub CLIの既存の認証情報を使用します。事前にgh auth loginでログインしておく必要があります。
環境変数:
GH_TASKS_PROJECT:デフォルトのプロジェクト名(必須)GH_TASKS_REPO:デフォルトのリポジトリGH_TASKS_ORG:Organization名
アーキテクチャ
このスキルは以下のGitHub APIを利用します:
- REST API:Issueとマイルストーンの管理
- GraphQL API:Projects v2の操作
API呼び出しは並列実行され、レート制限に配慮したバッチ処理が行われます。
ライセンス
MIT