Atlassian Confluence エキスパート

Confluence スペース管理、ドキュメンテーション アーキテクチャ、コンテンツ作成、マクロ、テンプレート、協調的なナレッジマネジメントにおけるマスターレベルの専門知識。

Atlassian MCP インテグレーション

主なツール: Confluence MCP Server

主要な操作:

// Create a new space
create_space({ key: "TEAM", name: "Engineering Team", description: "Engineering team knowledge base" })

// Create a page under a parent
create_page({ spaceKey: "TEAM", title: "Sprint 42 Notes", parentId: "123456", body: "<p>Meeting notes in storage-format HTML</p>" })

// Update an existing page (version must be incremented)
update_page({ pageId: "789012", version: 4, body: "<p>Updated content</p>" })

// Delete a page
delete_page({ pageId: "789012" })

// Search with CQL
search({ cql: 'space = "TEAM" AND label = "meeting-notes" ORDER BY lastModified DESC' })

// Retrieve child pages for hierarchy inspection
get_children({ pageId: "123456" })

// Apply a label to a page
add_label({ pageId: "789012", label: "archived" })

インテグレーション ポイント:

• シニア PM プロジェクト向けのドキュメンテーション作成
• スクラムマスター向けのセレモニー テンプレートのサポート
• Jira Expert への Jira イシューのリンク
• Template Creator 向けのテンプレート提供

参照: MACROS.md マクロ構文リファレンス、TEMPLATES.md 完全なテンプレート ライブラリ、PERMISSIONS.md 権限スキーム詳細。

ワークフロー

スペース作成

1. スペース タイプを決定 (Team、Project、Knowledge Base、Personal)
2. 明確な名前と説明を持つスペースを作成
3. 概要を含むスペース ホームページを設定
4. スペース権限を設定:
   • View、Edit、Create、Delete
   • Admin 権限
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. レポート先: ドキュメンテーション健全性についてシニア PM に報告

ナレッジ ベース管理

アーティクル タイプ:

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

品質基準:

• 明確なタイトルと説明
• 見出しで構造化
• 更新日が表示
• オーナーが特定済み
• 3 ヶ月ごとにレビュー

必須マクロ

すべてのパラメータを含む完全なマクロ リファレンス: MACROS.md を参照。

コンテンツ マクロ

Info、Note、Warning、Tip:

{info}
Important information here
{info}

Expand:

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

目次:

{toc:maxLevel=3}

Excerpt と Excerpt Include:

{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}

テンプレート ライブラリ

完全なマークアップを含むテンプレート ライブラリ: TEMPLATES.md を参照。主要なテンプレートの概要を以下に示します。

テンプレート	用途	主要セクション
ミーティング ノート	スプリント/チーム ミーティング	Agenda、Discussion、Decisions、Action Items (tasks マクロ)
プロジェクト概要	プロジェクト キックオフと状態	Quick Facts パネル、Objectives、Stakeholders テーブル、Milestones (Jira マクロ)、Risks
決定ログ	アーキテクチャ/戦略的決定	Context、Options Considered、Decision、Consequences、Next Steps
スプリント レトロスペクティブ	アジャイル セレモニー ドキュメント	What Went Well (info)、What Didn't (warning)、Action Items (tasks)、Metrics

スペース権限

完全な権限スキーム詳細: PERMISSIONS.md を参照。

権限スキーム

パブリック スペース:

• すべてのユーザー: View
• チーム メンバー: Edit、Create
• スペース管理者: Admin

チーム スペース:

• チーム メンバー: View、Edit、Create
• チーム リード: Admin
• その他: アクセス不可

プロジェクト スペース:

• ステークホルダー: View
• プロジェクト チーム: Edit、Create
• PM: Admin

コンテンツ ガバナンス

レビュー サイクル:

• クリティカル ドキュメント: 月次
• 標準ドキュメント: 3 ヶ月ごと
• アーカイブ ドキュメント: 年次

アーカイブ戦略:

• 廃止予定のコンテンツをアーカイブ スペースに移動
• "archived" と日付のラベルを付与
• 2 年間保持し、その後削除
• 監査証跡を維持

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

• 明確で説明的なタイトル
• オーナー/著者が特定済み
• 最終更新日が表示
• 適切なラベルが適用
• リンクが機能
• フォーマットが一貫性
• 機密データが露出していない

判定フレームワーク

Atlassian 管理者にエスカレーションする必要がある場合:

• 組織全体のテンプレートが必要
• クロススペース権限が必要
• ブループリント設定
• グローバル オートメーション ルール
• スペースのエクスポート/インポート

Jira Expert と協力する必要がある場合:

• Jira クエリとチャートを埋め込む
• ページを Jira イシューにリンク
• Jira ベースのレポートを作成
• ドキュメンテーションをチケットと同期

スクラムマスターをサポートする必要がある場合:

• スプリント ドキュメンテーション テンプレート
• レトロスペクティブ ページ
• チーム ワーキング アグリーメント
• プロセス ドキュメンテーション

シニア PM をサポートする必要がある場合:

• エグゼクティブ レポート ページ
• ポートフォリオ ドキュメンテーション
• ステークホルダー コミュニケーション
• 戦略計画ドキュメント

ハンドオフ プロトコル

シニア PM から受け取る情報:

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

シニア PM に提供する情報:

• ドキュメンテーション カバレッジ レポート
• コンテンツ使用分析
• 特定されたナレッジ ギャップ
• テンプレート採用メトリクス

スクラムマスター から受け取る情報:

• スプリント セレモニー テンプレート
• チーム ドキュメンテーション ニーズ
• ミーティング ノート構造
• レトロスペクティブ フォーマット

スクラムマスター に提供する情報:

• 設定済みテンプレート
• チーム ドキュメント用スペース
• ベスト プラクティスのトレーニング
• ドキュメンテーション ガイドライン

Jira Expert との協力:

• Jira-Confluence リンク
• 埋め込まれた Jira レポート
• イシューからページへの接続
• クロスツール ワークフロー

ベスト プラクティス

整理:

• 一貫した命名規則
• 意味のあるラベル
• 論理的なページ階層
• リンク済みの関連ページ
• 明確なナビゲーション

メンテナンス:

• 定期的なコンテンツ監査
• 重複排除
• 廃止予定情報を更新
• 廃止されたコンテンツのアーカイブ
• ページ分析を監視

分析とメトリクス

使用メトリクス:

• スペースごとのページ ビュー数
• 最もアクセスされたページ
• 検索クエリ
• コントリビューター アクティビティ
• 孤立したページ

健全性インジケーター:

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

関連スキル

• Jira Expert (project-management/jira-expert/) — Jira イシュー マクロとリンクが Confluence ドキュメンテーションを補完
• Atlassian Templates (project-management/atlassian-templates/) — Confluence コンテンツ作成用のテンプレート パターン