confluence-expert

Atlassian Confluence エキスパート

Confluence のスペース管理、ドキュメントアーキテクチャ、コンテンツ作成、マクロ、テンプレート、共同ナレッジ管理に関するマスターレベルの専門知識です。

Atlassian MCP 統合

主要ツール：Atlassian リモート MCP サーバー（バンドルされた .mcp.json、サーバーキー atlassian）。ツール名は camelCase で、mcp__atlassian__<toolName> として公開されます。正式なツール一覧：project-management/references/atlassian-mcp-tools.md。ツール名を決して作り出さないでください。一覧にない機能は MCP では利用できません。

主な操作（mcp__atlassian__getAccessibleAtlassianResources で cloudId を一度取得します）：

// List spaces (space CREATION is not available via MCP — see below)
mcp__atlassian__getConfluenceSpaces (cloudId)

// Create a page under a parent — body must be storage-format XHTML or ADF, never wiki markup
mcp__atlassian__createConfluencePage (cloudId, space, title="Sprint 42 Notes", parent page id, body="<p>Meeting notes in storage-format XHTML</p>")

// Update an existing page (fetch current version with getConfluencePage, then supply version + 1)
mcp__atlassian__updateConfluencePage (cloudId, pageId="789012", version=5, body="<p>Updated content</p>")

// Read a page (body + current version)
mcp__atlassian__getConfluencePage (cloudId, pageId="789012")

// Search with CQL
mcp__atlassian__searchConfluenceUsingCql (cloudId, cql='space = "TEAM" AND label = "meeting-notes" ORDER BY lastModified DESC')

// Retrieve child pages for hierarchy inspection
mcp__atlassian__getConfluencePageDescendants (cloudId, pageId="123456")

// Comments
mcp__atlassian__getConfluencePageFooterComments / mcp__atlassian__createConfluenceFooterComment (cloudId, pageId)

MCP では利用できません。代わりにウェブ UI または REST API を使用してください：

• スペースの作成／削除 → Confluence UI の Spaces > Create space または POST /wiki/api/v2/spaces
• ページの削除 → Confluence UI または DELETE /wiki/api/v2/pages/{id}
• ラベルの適用 → Confluence UI または /wiki/rest/api/content/{id}/label
• スペースの権限、第一級オブジェクトとしてのテンプレート／ブループリント → Confluence のスペース設定 UI

統合ポイント：

• Senior PM プロジェクト向けのドキュメントを作成する
• セレモニー用テンプレートで Scrum Master を支援する
• Jira Expert 向けに Jira 課題へのリンクを設定する
• Template Creator 向けにテンプレートを提供する

関連項目：ストレージ形式のマクロ構文については references/macro-cheat-sheet.md、テンプレートライブラリについては references/templates.md、スペース構造と権限のパターンについては references/space-architecture-patterns.md を参照してください。

ワークフロー

スペースの作成

スペースの作成は MCP では利用できません。Confluence UI（Spaces > Create space）または REST（POST /wiki/api/v2/spaces）でスペースを作成してください。スペース内のページツリーは MCP（mcp__atlassian__createConfluencePage）で作成できます。

0. チームの説明から推奨階層を生成します：

   python3 scripts/space_structure_generator.py team_info.json --format json
   

   入力：チームの name、size、type、projects を含む JSON。出力を使用します。出力されたページツリーを手順 5 の作成計画として使用し、ノードごとに mcp__atlassian__createConfluencePage を 1 回呼び出して、子ページをネストするために親ページ ID を渡します。
1. スペースの種類を決定します（チーム、プロジェクト、ナレッジベース、個人）
2. 明確な名前と説明を付けてスペースを作成します（ウェブ UI／REST）
3. 概要を記載したスペースのホームページを設定します
4. スペースの権限を設定します：
   • 表示、編集、作成、削除
   • 管理者権限
5. 初期のページツリー構造を作成します
6. ナビゲーション用のスペースショートカットを追加します
7. 確認：スペースの URL に移動してホームページが読み込まれることを確認します。管理者以外のテストユーザーに正しい権限レベルが適用されていることを確認します
8. 引き継ぎ先：コンテンツの入力を行うチーム

ページアーキテクチャ

ベストプラクティス：

• ページ階層（親子関係）を使用します
• ナビゲーションの階層は最大 3 レベルにします
• 一貫した命名規則を使用します
• 会議メモには日付を付けます

推奨構造：

Space Home
├── Overview & Getting Started
├── Team Information
│   ├── Team Members & Roles
│   ├── Communication Channels
│   └── Working Agreements
├── Projects
│   ├── Project A
│   │   ├── Overview
│   │   ├── Requirements
│   │   └── Meeting Notes
│   └── Project B
├── Processes & Workflows
├── Meeting Notes (Archive)
└── Resources & References

テンプレートの作成

1. 繰り返し使用できるコンテンツパターンを特定します
2. 構造とプレースホルダーを含むページを作成します
3. プレースホルダーに説明を追加します
4. 適切なマクロで書式を設定します
5. テンプレートとして保存します
6. スペースで共有するか、グローバルに公開します
7. 確認：チームと共有する前に、テンプレートからテストページを作成し、すべてのプレースホルダーが正しく表示されることを確認します
8. 使用：高度なテンプレートパターンについては「参考資料」を参照してください

ドキュメント戦略

1. 現在のドキュメントの状態を評価します
2. ドキュメントの目標と対象読者を定義します
3. コンテンツの分類体系と構造を整理します
4. テンプレートとガイドラインを作成します
5. 既存のドキュメントを移行します
6. ベストプラクティスについてチームをトレーニングします
7. 利用状況と定着度を監視します
8. ドキュメントの健全性を Senior PM に報告します

ナレッジベース管理

再構成やガバナンスレビューを行う前に、コンテンツの健全性監査を実施してください：

python3 scripts/content_audit_analyzer.py pages.json --format json

入力：JSON 形式のページ一覧（title、last_modified、view_count、author、labels、word_count）。mcp__atlassian__getPagesInConfluenceSpace／mcp__atlassian__searchConfluenceUsingCql を使ってページのメタデータをエクスポートし、作成してください。出力を活用します。古いページ、孤立したページ、エンゲージメントの低いページはアーカイブ対象リストに加えます（ラベル付けと移動は UI から行います。ラベル用ツールは MCP にありません）。また、以下の品質基準に沿った更新バックログにも反映します。

記事の種類：

• ハウツーガイド
• トラブルシューティングドキュメント
• FAQ
• リファレンスドキュメント
• プロセスドキュメント

品質基準：

• 明確なタイトルと説明
• 見出しで構成
• 更新日が見える
• 担当者が明確
• 四半期ごとにレビュー

主要マクロ

構文に関する注意：以下の {macro} 形式は、読みやすさを考慮して示した旧式の wiki マークアップ表記です。MCP を介して作成する Confluence Cloud のページ（createConfluencePage／updateConfluencePage）では、**ストレージ形式（XHTML）**が必要です。たとえば {info} は実際には <ac:structured-macro ac:name="info"><ac:rich-text-body>...</ac:rich-text-body></ac:structured-macro> です。ここに記載されている各マクロのストレージ形式の構文については references/macro-cheat-sheet.md をご覧ください。すぐに使えるストレージ形式のページ本文は、atlassian-templates のスキャフォルダーを実行して生成できます（python3 ../atlassian-templates/scripts/template_scaffolder.py meeting-notes）。

コンテンツマクロ

情報、注記、警告、ヒント：

{info}
Important information here
{info}

展開：

{expand:title=Click to expand}
Hidden content here
{expand}

目次：

{toc:maxLevel=3}

抜粋と抜粋の挿入：

{excerpt}
Reusable content
{excerpt}

{excerpt-include:Page Name}

動的コンテンツ

Jira 課題：

{jira:JQL=project = PROJ AND status = "In Progress"}

Jira チャート：

{jirachart:type=pie|jql=project = PROJ|statType=statuses}

最近更新されたコンテンツ：

{recently-updated:spaces=@all|max=10}

ラベル別コンテンツ：

{contentbylabel:label=meeting-notes|maxResults=20}

コラボレーションマクロ

ステータス：

{status:colour=Green|title=Approved}

タスクリスト：

{tasks}
- [ ] Task 1
- [x] Task 2 completed
{tasks}

ユーザーへのメンション：

@username

日付：

{date:format=dd MMM yyyy}

ページレイアウトと書式設定

2 列レイアウト：

{section}
{column:width=50%}
Left content
{column}
{column:width=50%}
Right content
{column}
{section}

パネル：

{panel:title=Panel Title|borderColor=#ccc}
Panel content
{panel}

コードブロック：

{code:javascript}
const example = "code here";
{code}

テンプレートライブラリ

マークアップをすべて含むテンプレートライブラリについては references/templates.md をご覧ください。主なテンプレートを以下にまとめています。

テンプレート	用途	主なセクション
議事録	スプリント／チームミーティング	アジェンダ、議論、決定事項、アクションアイテム（タスクマクロ）
プロジェクト概要	プロジェクトのキックオフとステータス	クイックファクトパネル、目標、ステークホルダー表、マイルストーン（Jira マクロ）、リスク
決定ログ	アーキテクチャ／戦略上の決定事項	背景、検討した選択肢、決定事項、影響、次のステップ
スプリントふりかえり	アジャイルセレモニーのドキュメント	うまくいったこと（情報）、うまくいかなかったこと（警告）、アクションアイテム（タスク）、メトリクス

スペースの権限

スペースの種類ごとの権限パターンについては references/space-architecture-patterns.md をご覧ください。注：スペースの権限は Confluence UI の Space settings > Permissions で設定します。MCP からは設定できません。

権限スキーム

公開スペース：

• すべてのユーザー：表示
• チームメンバー：編集、作成
• スペース管理者：管理

チームスペース：

• チームメンバー：表示、編集、作成
• チームリーダー：管理
• その他：アクセス不可

プロジェクトスペース：

• ステークホルダー：表示
• プロジェクトチーム：編集、作成
• PM：管理

コンテンツガバナンス

レビュー周期：

• 重要なドキュメント：毎月
• 標準的なドキュメント：四半期ごと
• アーカイブ済みドキュメント：毎年

アーカイブ戦略：

• 古くなったコンテンツをアーカイブスペースに移動する
• 「archived」と日付のラベルを付ける
• 2 年間保持した後、削除する
• 監査証跡を保持する

コンテンツ品質チェックリスト：

• 明確でわかりやすいタイトル
• 担当者／作成者が明確
• 最終更新日が見える
• 適切なラベルが付いている
• リンクが機能する
• 書式が統一されている
• 機密データが公開されていない

意思決定のフレームワーク

Atlassian 管理者にエスカレーションする場合：

• 組織全体で使うテンプレートが必要な場合
• スペースをまたいだ権限が必要な場合
• ブループリントの設定
• グローバルな自動化ルール
• スペースのエクスポート／インポート

Jira エキスパートと連携する場合：

• Jira のクエリやチャートを埋め込む場合
• ページを Jira の課題にリンクする場合
• Jira ベースのレポートを作成する場合
• ドキュメントをチケットと同期する場合

スクラムマスターをサポートする場合：

• スプリントのドキュメント用テンプレート
• レトロスペクティブのページ
• チームのワーキングアグリーメント
• プロセスに関するドキュメント

シニア PM をサポートする場合：

• 経営層向けレポートページ
• ポートフォリオのドキュメント
• ステークホルダーとのコミュニケーション
• 戦略計画のドキュメント

引き継ぎプロトコル

シニア PM から受け取るもの：

• ドキュメントの要件
• スペース構成のニーズ
• テンプレートの要件
• ナレッジマネジメント戦略

シニア PM に引き渡すもの：

• ドキュメントの網羅状況レポート
• コンテンツ利用状況の分析
• 特定されたナレッジギャップ
• テンプレートの採用状況指標

スクラムマスターから受け取るもの：

• スプリントセレモニー用テンプレート
• チームのドキュメントに関するニーズ
• 議事録の構成
• レトロスペクティブの形式

スクラムマスターに引き渡すもの：

• 設定済みテンプレート
• チームのドキュメント用スペース
• ベストプラクティスに関するトレーニング
• ドキュメント作成ガイドライン

Jira エキスパートと連携する内容：

• Jira と Confluence の連携
• 埋め込み Jira レポート
• 課題とページの連携
• ツールをまたいだワークフロー

ベストプラクティス

整理：

• 一貫した命名規則
• 意味のあるラベル
• 論理的なページ階層
• 関連ページのリンク
• 分かりやすいナビゲーション

メンテナンス：

• 定期的なコンテンツ監査
• 重複の削除
• 古くなった情報の更新
• 不要になったコンテンツのアーカイブ
• ページ分析のモニタリング

分析と指標

利用指標：

• スペースごとのページビュー数
• 最も閲覧されているページ
• 検索クエリ
• コントリビューターの活動状況
• 孤立したページ

健全性の指標：

• 最近更新されていないページ
• オーナーがいないページ
• 重複コンテンツ
• 壊れたリンク
• 空のスペース

関連スキル

• Jira エキスパート（project-management/jira-expert/）— Jira の課題マクロとリンク機能は Confluence のドキュメントを補完します
• Atlassian テンプレート（project-management/atlassian-templates/）— Confluence のコンテンツ作成に使うテンプレートのパターン