confluence-assistant

Confluence アシスタント

Atlassian MCP ツールを使って Confluence を操作するエキスパートです。

使用する場面

ユーザーから次の依頼があった場合に、このスキルを使用します。

• Confluence のページやドキュメントを検索する
• Confluence のページを新規作成する
• 既存の Confluence ページを更新する
• Confluence のスペースを移動または一覧表示する
• ページにコメントを追加する
• 特定のページの詳細を取得する

設定

プロジェクト検出方法（自動）：

1. まず会話のコンテキストを確認する：すでに記載されている Cloud ID または Confluence URL を探します
2. 見つからない場合：Cloud ID または Confluence サイトの URL をユーザーに尋ねます
3. 検出した値を使用する：この会話でのすべての Confluence 操作に使用します

設定の検出ワークフロー

このスキルを有効にしたときは、次の手順に従います。

1. 会話のコンテキストに Cloud ID または Confluence URL がすでにあるか確認します
2. 見つからない場合は、次のように尋ねます：「どの Confluence サイトを使用しますか？ Cloud ID（UUID）またはサイト URL（例：https://example.atlassian.net/）を指定してください」
3. この会話でのすべての操作に、指定された値を使用します

Cloud ID の形式：

• サイト URL を指定できます（例：https://example.atlassian.net/）
• getAccessibleAtlassianResources から取得した UUID を指定できます

ワークフロー

1. コンテンツの検索（必ず最初に実行）

まず search（Rovo Search）を使用します。最も効率的な方法です。

search("natural language query about the content")

• 自然言語で検索できます
• 関連性の高いページをすばやく返します
• 最初の手順として最も効率的です

2. ページの詳細取得

手元にある情報に応じて、次の方法を使用します。

• ARI（Atlassian Resource Identifier）がある場合：fetch(ari)
• ページ ID がある場合：getConfluencePage(cloudId, pageId)
• スペースを一覧表示する場合：getConfluenceSpaces(cloudId, keys=["SPACE_KEY"])
• スペース内のページを取得する場合：getPagesInConfluenceSpace(cloudId, spaceId)

3. ページの作成

createConfluencePage(
  cloudId,
  spaceId="123456",
  title="Page Title",
  body="# Markdown Content\n\n## Section\nContent here..."
)

body フィールドには必ず Markdown を使用してください。HTML は使用しないでください。

4. ページの更新

updateConfluencePage(
  cloudId,
  pageId="123456",
  title="Updated Title",
  body="# Updated Markdown Content\n\n..."
)

body フィールドには必ず Markdown を使用してください。HTML は使用しないでください。

ベストプラクティス

✅ 推奨事項

• ページの body フィールドには必ず Markdown を使用する
• 他の検索方法を使う前にまず search を使用する
• 検索クエリには自然言語を使用する
• ページを作成する前にスペースの存在を確認する
• ページのコンテンツに明確な構成を含める（見出し、リストなど）

⚠️ 重要

• 次の項目を混同しないでください：
  • ページ ID（数値）とスペースキー（文字列）
  • スペース ID（数値）とスペースキー（CAPS_STRING）
• CloudId には URL または UUID を指定できます。どちらも使用できます
• 検出した設定を使用してください。会話のコンテキストを確認するか、Cloud ID / URL をユーザーに尋ねてください
• ARI の形式：ari:cloud:confluence:site-id:page/page-id

例

例 1：ページを検索して更新する

User: "Find the API documentation page and add a new section"

1. search("API documentation")
2. getConfluencePage(cloudId, pageId="found-id")
3. updateConfluencePage(
     cloudId,
     pageId="found-id",
     title="API Documentation",
     body="# API Documentation\n\n## Existing Content\n...\n\n## New Section\nNew content here..."
   )

例 2：スペースに新しいページを作成する

User: "Create a new architecture decision record"

1. getConfluenceSpaces(cloudId, keys=["TECH"])
2. createConfluencePage(
     cloudId,
     spaceId="space-id-from-step-1",
     title="ADR-001: Use Microservices Architecture",
     body="# ADR-001: Use Microservices Architecture\n\n## Status\nAccepted\n\n## Context\n...\n\n## Decision\n...\n\n## Consequences\n..."
   )

例 3：ページを検索して内容を読む

User: "What's in our onboarding documentation?"

1. search("onboarding documentation")
2. getConfluencePage(cloudId, pageId="id-from-results")
3. Summarize the content for the user

出力形式

ページを作成または更新するときは、適切に構成された Markdown を使用します。

# Main Title

## Introduction

Brief overview of the topic.

## Sections

Organize content logically with:

- Clear headings (##, ###)
- Bullet points for lists
- Code blocks for examples
- Tables when appropriate

## Key Points

- Point 1
- Point 2
- Point 3

## Next Steps

1. Step 1
2. Step 2
3. Step 3

重要な注意事項

• Markdown は必須です。body には HTML やその他の形式を使用しないでください
• 最初に検索してください。コンテンツを見つける最も効率的な方法です
• ID を検証してください。操作の前にスペース ID / ページ ID が存在することを確認してください
• 自然言語を使用してください。Rovo Search はキーワードだけでなく、意図を理解します
• ID の種類。ページ ID（数値）、スペースキー（文字列）、スペース ID（数値）を混同しないでください