atlassian-templates について
atlassian-templatesは、JiraとConfluenceのテンプレートを作成、変更、管理するスキルです。組織のコンテンツ標準化に取り組むチーム向けに、動的テンプレート、ブループリント、バージョン管理、ライフサイクル管理を扱います。
主な機能
- 01Confluenceページテンプレート設計
- 02Jira課題の説明テンプレート
- 03複数ページのブループリント
- 04動的フィールドとマクロ
- 05テンプレートの版・ライフサイクル管理
- 06利用状況の追跡
活用シーン
- 01組織共通のConfluenceテンプレート作成
- 02Jira課題の説明形式の標準化
- 03個別文書から共通テンプレートへの移行
- 04マクロ障害や版の混乱の調査
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ borghei/ claude-skills --skill atlassian-templatesインストール後、Claude Code で/atlassian-templatesを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
examples/unified-prd-epic-story-rollout.mdreferences/confluence-templates.mdjira-templates.mdred-flags.mdtroubleshooting.mdworkflows-and-governance.mdscripts/template_scaffolder.pytemplate_usage_analyzer.pytemplate_validator.py詳細
Atlassian テンプレート&ファイル作成エキスパート
Jira と Confluence の再利用可能なテンプレートやファイルの作成、変更、管理を専門とします。ユースケースごとにテンプレートが乱立するのではなく、標準となるパラメーター化されたテンプレートを通じて一貫性を確保し、コンテンツ作成を効率化し、組織全体の標準を維持します。
主な機能
- テンプレート設計 — 動的コンテンツを含む Confluence ページテンプレート、Jira 課題テンプレート/説明、複数ページ構成向けのブループリント、バージョン管理
- コンテンツの標準化 — 組織全体の標準、再利用可能なコンポーネントやマクロ、テンプレートライブラリ、ドキュメント
- 自動化 — 動的フィールド、Jira 連携、自動更新される構成、テンプレートベースのワークフロー
- ガバナンス — ライフサイクル管理、バージョン管理、非推奨化、使用状況/導入状況の追跡
使用する場面
- 組織全体で使う Confluence ページテンプレートや Jira 課題テンプレートを作成する
- 複雑な複数ページのコンテンツ構成向けにブループリントを設計する
- コンテンツ標準と厳選されたテンプレートライブラリを確立する
- チームを場当たり的なゼロからのページ作成から、標準化されたテンプレートへ移行する
- テンプレートの導入率が低い、マクロが壊れている、またはバージョンが混乱している原因を診断する
まず確認すること
テンプレートを作成する前に、以下の情報を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。
- 対象ツールと成果物 — Confluence ページテンプレート、Jira 課題テンプレート、または複数ページのブループリント(利用できるマクロ/フィールドと構成が決まります)
- テンプレートの種類 — 議事録、PRD、憲章、バグ報告、決定ログなど(基本構成とプレースホルダーが決まります)
- 展開範囲 — 1 チーム向けか、組織全体で使用する標準テンプレートか(パラメーター化、命名、ガバナンスに影響します)
- 動的コンテンツと静的コンテンツ — マクロ/Jira クエリで自動入力するフィールドと、固定のプレースホルダー(構築の複雑さと導入に影響します)
中断ルール:出力に最も大きな影響を与える 2〜3 項目だけを質問してください。ユーザーが「とりあえず下書きを」と言った場合は作成を進め、成果物の冒頭に前提を記載してください。
クイックスタート
- ステークホルダーのニーズを把握し、既存のコンテンツパターンを確認します
- 明確なプレースホルダーとインラインの説明を含む構成を設計します
- マクロ(パネル、情報/注記、タスク、ステータス、動的な Jira クエリ)を使って構築します
- サンプルデータでテストし、対象のスペース/プロジェクトに公開します
- ユーザーをトレーニングし、導入状況を監視して、四半期ごとに改善します
以下のテンプレートライブラリからすぐに使えるひな形を選び、その後、references/workflows-and-governance.md に記載された作成/変更の完全なワークフローに従ってください。
参考資料
タスクに合った参考資料を読み込んでください。このファイルは簡潔に保ち、必要な詳細をその都度参照してください。
- references/confluence-templates.md — Confluence テンプレートの完全なライブラリ(議事録、プロジェクト憲章、スプリント振り返り、PRD、決定ログ)。すぐに貼り付けられる Confluence ページテンプレートが必要なときに読みます。
- references/jira-templates.md — Jira 課題テンプレートの完全なライブラリ(ユーザーストーリー、バグ報告、エピック)。すぐに貼り付けられる Jira の説明が必要なときに読みます。
- references/workflows-and-governance.md — 作成/変更/ブループリントの手順、ベストプラクティス、役割引き継ぎのプロトコル、ガバナンス、Atlassian MCP の操作。テンプレートの作成、変更、運用化を行うときに読みます。
- references/troubleshooting.md — トラブルシューティング表(導入、マクロの破損、バージョン管理、古いデータ)と測定可能な成功基準。公開済みテンプレートに問題がある場合や、完了条件を定義するときに読みます。
- references/red-flags.md — 悪い例/良い例を交えて、テンプレートの出力がうまくいかない一般的なケース(テンプレートの乱立など)を紹介します。テンプレートを組織全体に公開する前に読みます。
対象範囲と制限事項
対象範囲: Confluence ページテンプレートの設計とデプロイ、Jira 課題の説明テンプレート、ブループリントの開発、テンプレートのガバナンスとライフサイクル管理、テンプレートのバージョン管理、利用状況分析の追跡、テンプレートの使用方法に関するユーザートレーニング、マクロで拡張された動的テンプレート。
対象範囲外: Atlassian のグローバル管理(atlassian-admin/ に引き継ぎ)、Jira ワークフローと自動化の設計(jira-expert/ に引き継ぎ)、Confluence スペースのアーキテクチャ(confluence-expert/ に引き継ぎ)、コンテンツ戦略とドキュメント標準(confluence-expert/ に引き継ぎ)。
制限事項: Confluence Cloud のテンプレートには、すべての種類のマクロを含めることはできません(高度なマクロの一部は、ページ作成後に手動で挿入する必要があります)。Jira の課題テンプレートで指定できるのは説明フィールドの内容に限られます。自動化ルールを使用しない限り、カスタムフィールドの値を事前設定することはできません。詳細な利用状況指標を得るには、テンプレートの分析に Confluence Premium またはマーケットプレイスの分析アプリが必要です。
連携ポイント
| 連携 | 方向 | やり取りする内容 |
|---|---|---|
confluence-expert/ | 双方向 | Confluence エキスパートがコンテンツ標準を定義し、テンプレート作成者がそれをテンプレートとして実装します |
jira-expert/ | テンプレート -> Jira | 課題の説明テンプレート、ワークフローのドキュメントテンプレート |
atlassian-admin/ | 管理者 -> テンプレート | グローバルテンプレートのデプロイ承認、ガバナンスポリシー |
scrum-master/ | SM -> テンプレート | スプリントのセレモニー用テンプレートの要件、レトロスペクティブの形式に関する希望 |
senior-pm/ | PM -> テンプレート | エグゼクティブレポート用テンプレート、ポートフォリオ追跡のレイアウト |
delivery-manager/ | DM -> テンプレート | ポストモーテム用テンプレート、リリースチェックリスト用テンプレート、ランブックの構成 |