atlassian

Name: atlassian
Author: sanjay3290

github.com/sanjay3290生産性447311 回インストール7 週間前に更新

リポジトリ

atlassian について

atlassianは、JiraとConfluenceを操作するコマンドラインスキルです。Atlassian MCPサーバー経由のOAuth 2.1と、APIトークンによるREST APIへの直接アクセスに対応しています。

主な機能

01Jira課題の検索と管理
02Jira課題の作成、更新、ステータス変更
03Confluenceページとスペースの検索、管理
04OAuthまたはAPIトークン認証の選択
05機械可読なJSON出力

活用シーン

01JQLでJira課題を検索
02課題を更新してステータスを変更
03Confluenceドキュメントを検索または編集

MCP 対応

OAuthではAtlassian MCPサーバーのツールを呼び出し、APIトークンではAtlassian REST APIに直接接続します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sanjay3290/ai-skills --skill atlassian

インストール後、Claude Code で/atlassianを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.env.example

requirements.txt

scripts/

api_client.py

auth.py

confluence.py

jira.py

mcp_client.py

詳細

Atlassian（Jira + Confluence）

2 つの認証方法に対応した、Jira と Confluence の完全な統合です。

OAuth 2.1（Atlassian MCP サーバー経由）— ブラウザーでの同意、トークンの自動更新、MCP ツールの呼び出し
API token — メールアドレスとトークンをキーチェーンに保存し、REST API を直接呼び出します

初回セットアップ

オプション 1：MCP サーバー経由の OAuth 2.1（推奨）

API トークンやインスタンス URL は不要です。動的クライアント登録と PKCE を使用します。

pip install -r requirements.txt
python scripts/auth.py login --oauth

Atlassian の認証画面がブラウザーで開きます。アクセスを許可する製品（Jira、Confluence、Compass）を選択してください。トークンはシステムのキーチェーンに保存され、有効期限が切れると自動的に更新されます。

ステータスを確認します：

python scripts/auth.py status

オプション 2：API Token（代替手段）

ブラウザーでの OAuth を利用できない環境向けです。

pip install -r requirements.txt
python scripts/auth.py login

プロンプトに従って、Atlassian の URL、メールアドレス、API トークンを入力してください。認証情報はシステムのキーチェーンに安全に保存されます。

API トークンの作成先：https://id.atlassian.com/manage-profile/security/api-tokens

認証ステータスを確認します：

python scripts/auth.py status

ログアウト（OAuth と API トークンの両方の認証情報を消去します）：

python scripts/auth.py logout

バックエンドの選択

スクリプトは認証の種類に応じて、使用するバックエンドを自動的に検出します。

OAuth → MCP バックエンド（Atlassian MCP サーバーのツールを呼び出します）
API token → REST バックエンド（Atlassian REST API を直接呼び出します）

バックエンドにかかわらず、すべてのコマンドを同じように使用できます。

Jira（scripts/jira.py）

JQL で課題を検索

python scripts/jira.py search "project = DEV AND status = Open"
python scripts/jira.py search "assignee = currentUser() ORDER BY updated DESC" --limit 10

課題の詳細を取得

python scripts/jira.py get DEV-123

課題を作成

python scripts/jira.py create --project DEV --summary "Fix login bug" --type Bug
python scripts/jira.py create --project DEV --summary "New feature" --type Story \
  --description "Details here" --priority High --assignee "[email protected]" --labels "backend,urgent"

課題を更新

python scripts/jira.py update DEV-123 --summary "Updated summary" --priority High
python scripts/jira.py update DEV-123 --assignee "[email protected]"

課題のステータスを遷移

python scripts/jira.py transition DEV-123 "In Progress"
python scripts/jira.py transition DEV-123 "Done"

コメントを追加・一覧表示

python scripts/jira.py comment DEV-123 --add "This is a comment"
python scripts/jira.py comment DEV-123 --list

プロジェクトとステータスを一覧表示

python scripts/jira.py list-projects
python scripts/jira.py list-statuses DEV

認証をテスト

python scripts/jira.py auth-info

利用可能な MCP ツールを一覧表示（OAuth のみ）

python scripts/jira.py list-tools

Confluence（scripts/confluence.py）

ページを検索

python scripts/confluence.py search "deployment guide"
python scripts/confluence.py search "type=page AND space=DEV AND text~\"deployment\""
python scripts/confluence.py search "onboarding" --limit 10

ページを読む

python scripts/confluence.py read <page-id>
python scripts/confluence.py read <page-id> --json

スペースを一覧表示

python scripts/confluence.py list-spaces
python scripts/confluence.py list-spaces --limit 50

スペースの詳細を取得

python scripts/confluence.py get-space <space-id>

スペース内のページを一覧表示

python scripts/confluence.py list-pages --space-id <space-id>

ページを作成

python scripts/confluence.py create --title "New Page" --space-id <space-id>
python scripts/confluence.py create --title "Guide" --space-id <id> --body "<p>Content here</p>"
python scripts/confluence.py create --title "Child" --space-id <id> --parent-id <parent-id>

ページを更新

python scripts/confluence.py update <page-id> --title "Updated Title"
python scripts/confluence.py update <page-id> --body "<p>New content</p>"

子ページを取得

python scripts/confluence.py get-children <page-id>

認証をテスト

python scripts/confluence.py auth-info

利用可能な MCP ツールを一覧表示（OAuth のみ）

python scripts/confluence.py list-tools

操作リファレンス

Jira

コマンド	説明	必須の引数
search	JQL で課題を検索	jql
get	課題の詳細を取得	issue_key
create	新しい課題を作成	--project, --summary, --type
update	既存の課題を更新	issue_key
transition	課題のステータスを変更	issue_key, status
comment	コメントを追加または一覧表示	issue_key
list-projects	アクセス可能なプロジェクトを一覧表示	-
list-statuses	プロジェクトのステータスを一覧表示	project_key
auth-info	API 接続をテスト	-
list-tools	MCP ツールを一覧表示（OAuth のみ）	-

Confluence

コマンド	説明	必須の引数
search	CQL で検索	query
read	ページの内容を取得	page_id
list-spaces	すべてのスペースを一覧表示	-
get-space	スペースの詳細を取得	space_id
list-pages	スペース内のページを一覧表示	--space-id
create	新しいページを作成	--title, --space-id
update	既存のページを更新	page_id
get-children	子ページを取得	page_id
auth-info	API 接続をテスト	-
list-tools	MCP ツールを一覧表示（OAuth のみ）	-

JSON 出力

スクリプトコマンドに --json フラグを追加すると、機械可読形式で出力されます。

トークン管理

認証情報はシステムのキーチェーンを使って安全に保存されます。

macOS：Keychain
Windows：Windows Credential Locker
Linux：Secret Service API

サービス名：atlassian-skill

OAuth トークンは、有効期限が切れると自動的に更新されます（更新トークンが利用可能な場合）。

Markdown 対応

ログインしてコメント

基本情報

作者: sanjay3290
リポジトリ: sanjay3290/ai-skills
カテゴリ: 生産性
インストール数: 311
GitHub スター: 447

問題を報告

おすすめの Skills

すべての Skills

lark-base

open.feishu.cn

823.2k

Feishu Base を操作します。テーブル、フィールド、レコード、ビューの作成、統計、数式/lookup、フォーム、ダッシュボード、アプリモード（BaseApp/AppMode のページとコンポーネント）、Workspace ディレクトリ、ワークフロー、ロール権限、テンプレートセンター（Base テンプレートのカテゴリ/一覧/検索）に対応します。Base/多次元テーブル/bitable、BaseApp/AppMode、/base/ または /app/ リンクがある場合に使用します。BaseApp に lark-apps は使用しません。ファイルのインポート/エクスポートは lark-drive、認証/認可は lark-shared に振り分けます。

lark-drive

open.feishu.cn

823.2k

Feishu クラウドストレージ（Drive）：Drive のファイルとフォルダーを管理します。アップロード/ダウンロード、フォルダー作成、コピー/移動/削除、メタデータの表示、権限設定の確認、コメント/権限/購読、タイトル、バージョン、Feishu ドキュメントのセキュリティラベル（secure labels）、ローカルファイルのインポートに対応します。Drive フォルダーの整理、クラウドストレージのリソース URL/token の処理、リンクの種類/実際の token/タイトルの判定、Word/Markdown/Excel/CSV/PPTX/.base の docx/sheet/bitable/slides へのインポート時に使用します。doubao.com のクラウドストレージ URL/token もリソースパスと token に基づいて振り分け、WebFetch にフォールバックしません。対象外：ドキュメント内容の編集（lark-doc）、スプレッドシート/Base 内のデータ操作（lark-sheets/lark-base）、ナレッジスペースのノード/メンバー管理（lark-wiki）、ネイティブ Markdown ファイルの読み書き/patch/diff（lark-markdown）。

lark-shared

open.feishu.cn

822.9k

lark-cli のセットアップ/認証タスクに使用：auth login/status/logout、ユーザー vs bot ID、ビジネスドメイン権限 (--domain、all/docs/drive を含む)、スコープの不足、認可の取り消し、または _notice JSON の処理。

lark-im

open.feishu.cn

822.3k

Feishu インスタントメッセージ：メッセージの送受信とグループチャットの管理に対応します。メッセージの送信と返信、チャット履歴の検索、グループメンバーの管理、画像やファイルのアップロード/ダウンロード、絵文字リアクションの管理、アプリ内/SMS/電話での緊急通知、Interactive Card の送信と処理、カードボタンのコールバック（card.action.trigger）の監視ができます。メッセージの送信、チャット履歴の表示/検索、チャット内ファイルのダウンロード、グループメンバーの確認、グループ検索、グループチャットやトピックチャットの作成、マーカーデータの管理、Feed のピン留め（会話の追加/削除/検索）、タグデータの管理、カードコールバックの処理が必要な場合に使用します。