📋 Backlog Integration for VS Code

VS Code / Cursor 上で Backlog のタスク管理と開発フローを完結させる拡張機能

ブラウザとエディタを行き来するコンテキストスイッチを根絶しましょう！課題の確認、ステータス更新、コメント投稿から、Gitブランチの作成やプルリクエスト（PR）まで、開発に必要なすべての操作をIDE内でシームレスに実行できます。

✨ 主な機能 (Key Features)

1. タスク管理 (Task Management)

課題一覧表示: 担当者、ステータス、作成日などで課題をフィルタリング表示。
詳細確認: マークダウン形式で課題の詳細を閲覧可能。
クイックアクション: 課題の作成、コメントの投稿がサイドバーから即座に行えます。
Markdown出力: 課題リストや詳細をワンクリックでMarkdown形式で出力。日報作成やAIへのコンテキスト共有に便利です。

2. Gitワークフロー連携 (Git Workflow Integration)

Backlogの課題とGit操作を強力に結びつけます。

スマートブランチ作成: 課題キー（例: PROJ-123）を含んだブランチを自動生成・チェックアウト。
カスタマイズ可能なプレフィックス（feature/, bugfix/など）。
ベースブランチの選択や、作成後の自動チェックアウトも設定可能。
コミットメッセージ補完: ブランチ名から課題キーを検出し、コミットメッセージに自動挿入（例: [PROJ-123] ...）。
プルリクエスト作成: IDEから直接 Backlog Git のプルリクエストを作成可能。
ブランチお掃除機能: マージ済みの不要なブランチを視覚的に選択して一括削除できます。

3. 直感的なUIと設定 (Intuitive UI & Settings)

3つの専用タブ: 「課題一覧」「新規タスク」「設定」の3タブ構成で迷わず操作。
ステータス同期: Backlog上のカスタムステータスや課題種別をワンクリックで同期。
VS Code Native: VS Codeのデザインシステムに準拠し、ダークモードにも完全対応。

🚀 始め方 (Getting Started)

拡張機能をインストールします。
サイドバーのアクティビティバーに表示される Backlog アイコンをクリックします。
「設定 (Settings)」タブ を開きます。
以下の情報を入力して保存します：

Space URL: BacklogのスペースURL (例: https://your-space.backlog.jp)
Project ID: 対象のプロジェクトID (数値) またはプロジェクトキー
API Key: Backlogの個人設定から発行したAPIキー

「課題一覧」タブ に移動し、「更新」ボタンを押すと課題が表示されます。

⚙️ 設定項目 (Extension Settings)

サイドバーの設定タブ、または settings.json から詳細なカスタマイズが可能です。

基本設定

backlog.projectId: 接続するプロジェクトIDまたはキー。
backlog.maxIssues: 取得する課題の最大件数（デフォルト: 100）。
backlog.apiCooldownSeconds: API連打防止のためのクールダウン時間。

Git連携設定

backlog.branchPrefixes: ブランチ作成時に選択できるプレフィックス一覧（feature/, hotfix/ 等）。
backlog.commitMessageFormat: コミットメッセージのフォーマット。

🔒 セキュリティ (Security & Privacy)

APIキーの保護: 入力されたBacklog APIキーやアクセストークンは、VS Codeの SecretStorage APIを使用して暗号化され、安全に保存されます。settings.json に平文で保存されることはありません。
通信: すべての通信は Backlog API (HTTPS) との間で直接行われます。外部の第三者サーバーを経由することはありません。

💡 ヒント (Tips)

AIとの連携: 「MD取得」ボタンで課題情報をMarkdown化し、CursorなどのAIチャットにペーストすることで、文脈を共有しながらコーディングの相談が可能です。
フィルタの保存: 課題一覧タブで設定したフィルタ条件（担当者やステータス）は、タブを切り替えても保持されます。

📚 参考資料 (References)

Backlog API ドキュメント: https://developer.nulab.com/ja/docs/backlog/
- 本拡張機能は Backlog API を使用して実装されています。

🐛 バグ報告・機能リクエスト (Bug Reports & Feature Requests)

バグの報告や機能リクエストは、こちらまでお願いします。

📝 リリースノート

📄 ライセンス (License)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Backlog-IDE-Extension

uzin-60123