AI エージェント連携

backlog-cli は Agent Skill を同梱しており、AI コーディングエージェントに backlog-cli の操作方法を自動的に教えることができます。

スキルをインストールすると、ハウトゥーの説明なしにエージェントへ直接「PROJ-123 の課題を処理中にして」「PR を作成して」といった指示を出せるようになります。

対応エージェント

skills CLI は 35 以上のエージェントに対応しています。主な対応エージェントは次のとおりです。

• Claude Code
• Cursor
• OpenAI Codex
• Windsurf
• その他（Gemini CLI, GitHub Copilot, Roo, OpenCode など）

インストール

skills CLI を使う（推奨）

npx skills add simochee/backlog-cli

インタラクティブにインストール先のエージェントを選択できます。特定のエージェントも指定できます。

# Claude Code にインストール
npx skills add simochee/backlog-cli -a claude-code -y

# Cursor にインストール
npx skills add simochee/backlog-cli -a cursor -y

全プロジェクトで利用する場合は、グローバルにインストールします。

npx skills add simochee/backlog-cli -g

手動インストール

リポジトリの skills/backlog-cli/ ディレクトリを、エージェントのスキルディレクトリにコピーします。

# Claude Code の場合
cp -r skills/backlog-cli/ ~/.claude/skills/backlog-cli/

# プロジェクトローカルの場合
cp -r skills/backlog-cli/ .claude/skills/backlog-cli/

スキルの内容

インストールされるスキルの内容は次のとおりです。

ファイル	内容
SKILL.md	コマンドの使い方、認証、名前解決、主要ワークフローの説明
references/commands.md	全 99 コマンドのフラグ・オプション一覧
references/schema.md	--json 出力のデータモデル定義（Issue, PR, Project 等）

使い方の例

スキルのインストール後、エージェントに自然言語で Backlog 操作を指示できます。

• 「PROJ-123 の詳細を見せて」
• 「自分に割り当てられた未完了の課題を一覧して」
• 「この変更を PR にして PROJ-456 に紐づけて」
• 「PROJ-789 を処理中にしてコメントを追加して」
• 「プロジェクト MYAPP の課題種別一覧を確認して」

エージェントはスキルの情報をもとに、対応する backlog コマンドを組み立てて実行します。

前提条件

エージェントが backlog-cli を利用するには、事前に次の準備が必要です。

1. @simochee/backlog-cli がインストール済み（npm install -g @simochee/backlog-cli）
2. backlog auth login で認証済み

認証方法の詳細は 認証ガイド を参照してください。