atlassian-templates

Atlassian テンプレート＆ファイル作成エキスパート

Jira と Confluence 用の再利用可能なテンプレートやファイルの作成、変更、管理を専門とします。一貫性を確保し、コンテンツ作成を効率化し、組織全体の標準を維持します。

---

ワークフロー

テンプレート作成プロセス

1. ニーズの把握：関係者にヒアリングし、ニーズを理解します
2. 分析：既存のコンテンツパターンを確認します
3. 設計：テンプレートの構成とプレースホルダーを作成します
4. 実装：マクロと書式を使ってテンプレートを構築します
5. テスト：サンプルデータで検証し、公開前にプレビューでテンプレートが正しく表示されることを確認します
6. 文書化：使用手順を作成します
7. 公開：MCP 経由で適切なスペース／プロジェクトに展開します（以下の「MCP 操作」を参照）
8. 確認：展開が成功したことを確認します。エラーが発生した場合は、以前のバージョンにロールバックします
9. トレーニング：ユーザーにテンプレートの使い方を説明します
10. 監視：利用状況を追跡し、フィードバックを収集します
11. 反復：利用状況に基づいて改善します

テンプレート変更プロセス

1. 評価：変更依頼と影響を確認します
2. バージョン管理：新しいバージョンを作成し、旧バージョンも利用できる状態にしておきます
3. 変更：テンプレートの構成／コンテンツを更新します
4. テスト：変更によって既存の使い方に支障が出ないことを検証します。公開前に更新したテンプレートをプレビューします
5. 移行：既存コンテンツの移行手順を提示します
6. 周知：変更をユーザーに告知します
7. サポート：移行をユーザーに支援します
8. アーカイブ：移行後に旧バージョンを非推奨にします。非推奨のテンプレートが削除されず、一覧から除外されていることを確認します

ブループリントの開発

1. ブループリントの範囲と目的を定義します
2. 複数ページの構成を設計します
3. 各セクションのページテンプレートを作成します
4. ページ作成ルールを設定します
5. 動的コンテンツ（Jira クエリ、ユーザーデータ）を追加します
6. サンプルスペースでブループリントの作成フローを最初から最後までテストします
7. 展開前に、すべてのマクロ参照が正しく解決されることを確認します
8. 引き継ぎ先：全体展開を担当する Atlassian 管理者

---

Confluence テンプレートライブラリ

テンプレートの設計パターンについては references/template-design-patterns.md を、ガバナンスモデルについては references/governance-framework.md を参照してください。展開用のストレージ形式マークアップには、同梱のスキャフォルダーを使用してください（以下のテンプレートスキャフォルダーを参照）。以下では、このスキルで作成・管理する標準的な種類をまとめています。

Confluence テンプレートの種類

テンプレート	目的	主な使用マクロ
議事録	議題、決定事項、アクション項目を含む構造化された会議記録	{date}, {tasks}, {panel}, {info}, {note}
プロジェクト憲章	組織レベルのプロジェクト範囲、ステークホルダーの RACI、スケジュール、予算	{panel}, {status}, {timeline}, {info}
スプリントふりかえり	「うまくいったこと／うまくいかなかったこと／アクション」を扱うアジャイルセレモニー用テンプレート	{panel}, {expand}, {tasks}, {status}
PRD	目標、ユーザーストーリー、機能要件／非機能要件、リリース計画を含む機能定義	{panel}, {status}, {jira}, {warning}
決定ログ	判断マトリクスと実施状況の追跡を含む構造化された選択肢の分析	{panel}, {status}, {info}, {tasks}

標準セクションとして、すべての Confluence テンプレートに次の内容を含めます。

• メタデータ（担当者、日付、ステータス）を含むヘッダーパネル
• インラインのプレースホルダー説明を添えた、明確にラベル付けされたコンテンツセクション
• {tasks} マクロを使用したアクション項目ブロック
• 関連リンクと参考資料

完全な例：議事録テンプレート

形式に関する警告：以下の例は、人間が読みやすいように示した旧式の Wiki マークアップ（{panel}、h2.、{tasks}）です。Wiki マークアップは Confluence のストレージ形式ではなく、ストレージ形式（XHTML、<ac:structured-macro> 要素）または ADF を想定する mcp__atlassian__createConfluencePage／updateConfluencePage では拒否されます。デプロイ可能なストレージ形式の同等版を取得するには、スキャフォルダーを実行してください：python3 scripts/template_scaffolder.py meeting-notes（テンプレートスキャフォルダーを参照）。

{panel:title=Meeting Metadata|borderColor=#0052CC|titleBGColor=#0052CC|titleColor=#FFFFFF}
*Date:* {date}
*Owner / Facilitator:* @[facilitator name]
*Attendees:* @[name], @[name]
*Status:* {status:colour=Yellow|title=In Progress}
{panel}

h2. Agenda
# [Agenda item 1]
# [Agenda item 2]
# [Agenda item 3]

h2. Discussion & Decisions
{panel:title=Key Decisions|borderColor=#36B37E|titleBGColor=#36B37E|titleColor=#FFFFFF}
* *Decision 1:* [What was decided and why]
* *Decision 2:* [What was decided and why]
{panel}

{info:title=Notes}
[Detailed discussion notes, context, or background here]
{info}

h2. Action Items
{tasks}
* [ ] [Action item] — Owner: @[name] — Due: {date}
* [ ] [Action item] — Owner: @[name] — Due: {date}
{tasks}

h2. Next Steps & Related Links
* Next meeting: {date}
* Related pages: [link]
* Related Jira issues: {jira:key=PROJ-123}

その他の組み込みタイプ（decision-log、runbook、project-kickoff）のストレージ形式の例は python3 scripts/template_scaffolder.py --list で取得できます。残りのタイプ（Project Charter、Sprint Retrospective、PRD）のデザインパターンは references/template-design-patterns.md にあります。

---

Jira テンプレートライブラリ

Jira テンプレートの種類

テンプレート	目的	主なセクション
ユーザーストーリー	As a／I want／So that 形式の機能リクエスト	受け入れ条件（Given／When／Then）、デザインへのリンク、技術メモ、完了の定義
バグレポート	再現手順を含む不具合の記録	環境、再現手順、期待される動作と実際の動作、重大度、回避策
エピック	高レベルの取り組みの範囲	ビジョン、目標、成功指標、ストーリーの内訳、依存関係、タイムライン

すべての Jira テンプレートに含まれる標準セクション：

• 明確な概要行
• チェックボックス形式の受け入れ条件または成功基準
• 関連する課題と依存関係のブロック
• 完了の定義（ストーリー用）

---

マクロの使用ガイドライン

動的コンテンツ：日付、ユーザーへのメンション、Jira クエリなど、更新が自動化されるコンテンツにはマクロを使用します 視覚的な階層：{panel}、{info}、{note} を使用して視覚的な区別を作ります インタラクティブ性：長いテンプレートの折りたたみ可能なセクションには {expand} を使用します 連携：ライブデータには {jira} マクロを使用して Jira のチャートやテーブルを埋め込みます

---

テンプレートスキャフォルダー — ストレージ形式のマークアップを生成

同梱のスキャフォルダーはConfluence ストレージ形式の XHTMLを出力します。これは createConfluencePage／updateConfluencePage が受け付ける本文形式そのものです。このスキルでの標準的なデプロイ方法です：

# List available template types (meeting-notes, decision-log, runbook, project-kickoff, custom)
python3 scripts/template_scaffolder.py --list

# Generate a template body (storage-format XHTML)
python3 scripts/template_scaffolder.py meeting-notes

# Custom template with chosen sections and macros, JSON output for programmatic use
python3 scripts/template_scaffolder.py custom --sections "Overview,Goals,Action Items" --macros "toc,status,info" --format json

出力を使用するには、（テキストモードでは）CONFLUENCE STORAGE FORMAT MARKUP ブロック、または（JSON モードでは）マークアップフィールドを取得し、mcp__atlassian__createConfluencePage の body としてそのまま渡します。提案されたラベルは、その後 Confluence UI から適用してください（ラベル用ツールは MCP では利用できません）。

Atlassian MCP 連携

主なツール：Atlassian リモート MCP サーバー（同梱の .mcp.json、サーバーキー atlassian）。ツールは mcp__atlassian__<toolName>（キャメルケース）として公開されます。正式なツール一覧：project-management/references/atlassian-mcp-tools.md。ツール名を決して推測しないでください。機能が一覧にない場合、MCP では利用できません。Web UI または REST API を使用してください。

MCP によるテンプレート操作

mcp__atlassian__getAccessibleAtlassianResources を使用して、cloudId を一度取得します。山括弧で囲まれたプレースホルダーを実際の値に置き換えます。正確なパラメーター名は、各ツールのスキーマを呼び出し時に確認してください。

Confluence テンプレートページを作成する（本文は上記のスキャフォールダーから取得）：

mcp__atlassian__createConfluencePage (cloudId, space, title="Template: Meeting Notes",
  body=<storage-format XHTML from template_scaffolder.py>, parent page id optional)

ラベル（template、meeting-notes）は Confluence の UI で適用する必要があります。MCP のラベル用ツールはありません。

既存のテンプレートページを更新する（最初に読み込んで現在のバージョンを取得してください）：

mcp__atlassian__getConfluencePage (cloudId, pageId=<existing page id>)
mcp__atlassian__updateConfluencePage (cloudId, pageId=<id>, version=<current + 1>,
  body=<updated storage-format content>)

Jira 課題の説明テンプレート：フィールド設定（説明フィールドの default_value、画面、フィールドコンテキスト）を行う MCP ツールはありません。説明のデフォルト値は、Jira 管理 UI（Settings > Issues > Field configurations）または REST（/rest/api/3/fieldconfiguration）で設定してください。MCP でできること：mcp__atlassian__createJiraIssue を使用して、テンプレートのテキストをあらかじめ入力した課題を作成する（テンプレート本文を説明として渡します）、および mcp__atlassian__getJiraIssueTypeMetaWithFields を使用して、課題タイプごとの必須フィールドを確認する。

Confluence の標準テンプレート／ブループリントも、MCP では作成できません。createConfluencePage は、コピー元テンプレートとして機能する通常のページを作成します。実際のスペーステンプレートを登録するには、UI の Space settings > Templates を使用してください。

テンプレートページを複数のスペースにデプロイする（一括処理）：

# Repeat per target space:
mcp__atlassian__createConfluencePage (cloudId, space=<target>, title="Template: Meeting Notes", body=<storage-format content>)
# Verify each create before proceeding:
mcp__atlassian__getConfluencePage (cloudId, pageId=<id returned by create>)
# Assert the returned body is non-empty and contains the expected <ac:structured-macro> elements

デプロイ後の検証チェックポイント：

• mcp__atlassian__getConfluencePage で作成／更新したページを取得し、マクロエラーなしで表示されることを確認します
• Jira マクロの埋め込みが対象の Jira プロジェクトで解決されることを確認します
• 公開ビューでタスクブロックが操作可能であることを確認します
• いずれかのチェックに失敗した場合：version: <current + 1> と以前のバージョンの本文を指定して mcp__atlassian__updateConfluencePage を使用し、元に戻します

---

ベストプラクティスとガバナンス

組織固有の標準：

• ページヘッダーにバージョンメモを記載してテンプレートのバージョンを管理します
• 古くなったテンプレートにはアーカイブ前に {warning} バナーを付けます。削除せず、アーカイブしてください
• 各テンプレートからリンクする使用ガイドを整備します
• 四半期ごとのレビューサイクルでフィードバックを収集し、廃止する前に使用状況の指標を反映します

品質ゲート（デプロイ前に毎回適用）：

• 各セクションに記入例が用意されている
• プレビューでサンプルデータを使用してテスト済みである
• 変更ログにバージョンコメントが追加されている
• フィードバック手段が用意されている（コメントが有効、またはアンケートへのリンクがある）

ガバナンスプロセス：

1. 依頼とその理由
2. 設計とレビュー
3. パイロットユーザーによるテスト
4. ドキュメント作成
5. 承認
6. デプロイ（MCP 経由または手動）
7. トレーニング
8. モニタリング

---

引き継ぎプロトコル

引き継ぎの概要（ガバナンスのコンテキストは references/governance-framework.md）：

パートナー	受け取る内容	送る内容
シニア PM	テンプレートの要件、レポート用テンプレート、経営陣向けフォーマット	完成したテンプレート、使用状況の分析、最適化の提案
スクラムマスター	スプリントセレモニーのニーズ、チーム固有の依頼、レトロの形式に関する希望	スプリントですぐに使えるテンプレート、アジャイルセレモニーの構成、ベロシティ追跡用テンプレート
Jira エキスパート	課題テンプレートの要件、カスタムフィールドの表示要件	課題の説明テンプレート、フィールド設定テンプレート、JQL クエリテンプレート
Confluence エキスパート	スペース固有のニーズ、グローバルテンプレートの依頼、ブループリントの要件	設定済みのページテンプレート、ブループリントの構成、デプロイ計画
Atlassian 管理者	組織全体の標準、グローバルデプロイの要件、コンプライアンステンプレート	承認用のグローバルテンプレート、使用状況レポート、コンプライアンス状況