Backlog プロジェクトのメタデータ(ステータス、種別、優先度、メンバー等)を参照するスキルです。
結果は .cc-backlog/ ディレクトリにキャッシュされ、次回以降は API コールなしに即座に返します。
事前チェック
まず .cc-backlog/config.json が存在するか確認してください。
存在しない場合は、操作を実行せず以下のように案内してください:
Backlog の接続設定がまだ行われていません。先に
/cc-backlog-connect:configを実行して設定してください。
実行方法
# 通常実行(キャッシュがあればキャッシュから返す)
node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info <type>
# 強制更新(キャッシュを無視して API から再取得)
node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info <type> --refresh
利用可能なタイプ
| タイプ | 説明 | コマンド |
|---|---|---|
statuses |
課題ステータス一覧 | node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info statuses |
issue-types |
課題種別一覧 | node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info issue-types |
priorities |
優先度一覧 | node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info priorities |
resolutions |
完了理由一覧 | node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info resolutions |
users |
プロジェクトメンバー一覧 | node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info users |
categories |
カテゴリ一覧 | node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info categories |
versions |
バージョン/マイルストーン一覧 | node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info versions |
キャッシュ動作
- 初回実行: Backlog API を呼び出し、
.cc-backlog/<type>.jsonにキャッシュして返す - 2回目以降: キャッシュから即座に返す(API コールなし)
--refreshフラグ: キャッシュがあっても API から再取得してキャッシュを更新
# キャッシュを強制更新する場合
node "${CLAUDE_PLUGIN_ROOT}/dist/index.js" project-info statuses --refresh
出力形式
全タイプ共通で JSON 配列を出力します。各要素には最低限 id と name フィールドが含まれます。
ユーザーに表示する際は、テーブル形式等で見やすく整形してください。
他のSkillからの利用
このコマンドは、backlog-issue スキルや backlog-comment スキルからID解決のために内部的に利用されます。
v0.3.0 以降は名前ベースフラグ(--status "完了" 等)を使えばこのコマンドの明示的な呼び出しは不要です。
例: ユーザーが「ステータスを完了にして」と言った場合
- キャッシュがある場合:
issue update PROJ-123 --status "完了"を直接実行(API 往復なし) - キャッシュがない場合:
project-info statusesでステータス一覧を取得後、issue update PROJ-123 --status-id <id>で更新
詳細リファレンス
- 各タイプのJSON出力構造の詳細は reference.md を参照