| name | backlog-api |
| description | This skill should be used when the user asks to "create issue", "search issues", "update ticket", "check notifications", mentions "Backlog", "バックログ", "課題", "チケット", discusses project management with Nulab Backlog, or needs to interact with Backlog API for issue tracking. |
| version | 1.0.0 |
Backlog API Skill
Nulab Backlogと連携するためのスキル。Bashツールでスクリプトを実行してBacklog APIを呼び出します。
スクリプトの実行方法
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts <command> [args...]
注:
${CLAUDE_PLUGIN_ROOT}はClaude Codeが自動的にプラグインのルートディレクトリに展開します。
環境変数が必要:
BACKLOG_DOMAIN- Backlogスペースのドメイン（例: mycompany.backlog.com）BACKLOG_API_KEY- Backlog APIキー
出力形式: すべてのコマンドはJSON形式で出力します。
利用可能なコマンド
情報取得
# スペース情報
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-space
# 自分の情報
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-myself
# ユーザー一覧
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-users
# 優先度一覧
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-priorities
プロジェクト
# プロジェクト一覧
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-projects
# プロジェクト詳細
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-project MYPROJ
# 課題種別一覧（課題作成に必要）
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-issue-types MYPROJ
# カテゴリ一覧
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-categories MYPROJ
課題
# 課題検索
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-issues --project=123 --status=2 --keyword=バグ --count=20
# 課題詳細
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-issue MYPROJ-123
# 課題作成（JSON形式）
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts create-issue '{"projectId":123,"summary":"タイトル","issueTypeId":456,"priorityId":3}'
# 課題更新（JSON形式）
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts update-issue MYPROJ-123 '{"statusId":3,"comment":"完了しました"}'
# コメント追加
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts add-comment MYPROJ-123 "進捗報告です"
# コメント一覧
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-comments MYPROJ-123
通知
# 通知一覧
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-notifications --count=20
# 未読件数
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts count-notifications
重要: 課題作成の手順
課題を作成するには、事前にIDを取得する必要があります：
プロジェクトIDを取得
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-project MYPROJ # → id フィールドを確認課題種別IDを取得
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-issue-types MYPROJ # → 「タスク」「バグ」等のidを確認優先度IDを取得
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-priorities # → 通常: 2=高, 3=中, 4=低課題作成
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts create-issue '{"projectId":12345,"summary":"課題タイトル","issueTypeId":67890,"priorityId":3,"description":"詳細説明"}'
ステータスID（標準設定）
| ID | ステータス |
|---|---|
| 1 | 未対応 |
| 2 | 処理中 |
| 3 | 処理済み |
| 4 | 完了 |
get-issues オプション
| オプション | 説明 | 例 |
|---|---|---|
--project=ID |
プロジェクトIDで絞り込み | --project=123 |
--status=ID |
ステータスIDで絞り込み | --status=2 |
--priority=ID |
優先度IDで絞り込み | --priority=2 |
--assignee=ID |
担当者IDで絞り込み | --assignee=456 |
--keyword=TEXT |
キーワード検索 | --keyword=バグ |
--count=N |
取得件数（最大100） | --count=50 |
--offset=N |
オフセット | --offset=20 |
--sort=FIELD |
ソート項目 | --sort=updated |
| `--order=asc | desc` | ソート順 |
create-issue パラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
projectId |
Yes | プロジェクトID（数値） |
summary |
Yes | 課題タイトル |
issueTypeId |
Yes | 課題種別ID（数値） |
priorityId |
Yes | 優先度ID（数値） |
description |
No | 詳細説明 |
assigneeId |
No | 担当者ID（数値） |
dueDate |
No | 期限日（yyyy-MM-dd） |
startDate |
No | 開始日（yyyy-MM-dd） |
update-issue パラメータ
| パラメータ | 説明 |
|---|---|
summary |
新しいタイトル |
description |
新しい説明 |
statusId |
新しいステータスID |
priorityId |
新しい優先度ID |
assigneeId |
新しい担当者ID |
dueDate |
新しい期限日 |
comment |
更新時のコメント |
エラーハンドリング
| エラー | 原因 | 対処 |
|---|---|---|
BACKLOG_DOMAIN environment variable is required |
環境変数未設定 | BACKLOG_DOMAINを設定 |
BACKLOG_API_KEY environment variable is required |
環境変数未設定 | BACKLOG_API_KEYを設定 |
API Error 401 |
認証エラー | APIキーを確認 |
API Error 404 |
リソースなし | 課題キー/プロジェクトキーを確認 |
API Error 400 |
パラメータ不正 | 必須パラメータを確認 |
使用例
自分が担当の処理中課題を表示
# 1. 自分のIDを取得
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-myself
# → id: 12345
# 2. 課題検索
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts get-issues --assignee=12345 --status=2
課題をクローズしてコメント
bun run ${CLAUDE_PLUGIN_ROOT}/scripts/backlog.ts update-issue MYPROJ-123 '{"statusId":4,"comment":"対応完了しました"}'