atlassian について
Atlassian の認証情報が利用できる環境で、Jira と Confluence を API 経由で操作するためのスキルです。認証情報を確認し、読み取りを先行させ、書き込み前に対象と変更内容を確認します。
主な機能
- 01環境変数の設定状況を確認
- 02Jira への対象を絞った REST リクエスト
- 03Confluence への対象を絞った REST リクエスト
- 04書き込み前に対象と変更内容を確認
- 05最小限の証拠とアクセス状況を報告
活用シーン
- 01Jira の課題の状態と概要を確認
- 02Confluence のページやスペースを検索
- 03確認後に課題やページを更新
- 04認証・権限・ネットワークの問題を特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ i9wa4/ dotfiles --skill atlassianインストール後、Claude Code で/atlassianを入力して読み込まれたか確認します。
同梱ファイルreferences/api-token.mdreferences/usage.md
詳細
Atlassian
Jira または Confluence を使用するタスクで、環境に Atlassian の認証情報がすでに設定されている可能性がある場合は、このスキルを使用してください。必要な変数が存在することを確認してから、認証情報が利用可能であると判断してください。
認証済みの Atlassian リクエストを行う前に、使用方法を読んでください。
1. 必須の環境変数
ATLASSIAN_SITE:Atlassian Cloud サイトの URL。ATLASSIAN_EMAIL:API トークン認証に使用するアカウントのメールアドレス。ATLASSIAN_API_TOKEN:Atlassian API トークン。ATLASSIAN_CLOUD_ID:Cloud ID を必要とする Confluence API で使用する任意の変数。
ATLASSIAN_API_TOKEN が設定されていない場合は、API トークンに従ってください。
値ではなく、設定されているかどうかを確認してください。結果として set または missing のみを出力するリファレンスのコマンド、または同等のコマンドを使用してください。認証情報の値、認証ヘッダー、Cookie、シェルトレースを絶対に出力しないでください。
2. ワークフロー
- アクセスする前に、必須の環境変数が設定されていることを確認してください。URL からアクセス可能だと推測しないでください。
- Jira:課題、検索、コメント、トランジション、またはメタデータには、対象を絞った REST 呼び出しを使用してください。アクセス確認では、
summary,statusのような最小限のフィールドをリクエストしてください。 - Confluence:ページ、検索、コメント、またはスペースには、対象を絞った REST 呼び出しを使用してください。タスクで必要な本文の形式のみをリクエストしてください。
- まず読み取り専用の確認を優先してください。書き込みを行う場合は、対象の課題またはページを確認し、実行前に予定している変更を要約してください。
3. 報告
アクセスが読み取り可能か、認証でブロックされているか、権限でブロックされているか、ネットワークでブロックされているか、または見つからなかったかを明記してください。Jira の課題キー/タイトル/ステータス、または Confluence のページ ID/タイトル/ステータスと HTTP 結果など、最小限の根拠のみを含めてください。
コメント
Markdown 対応