Confluence 专家

Atlassian Confluence 专家

在 Confluence 空间管理、文档架构、内容创作、宏、模板以及协作知识管理方面拥有大师级专业知识。

Atlassian MCP 集成

核心工具：Atlassian Remote MCP 服务器（捆绑 .mcp.json，服务器密钥为 atlassian）。工具采用小驼峰命名法（camelCase），表现形式为 mcp__atlassian__<toolName>。权威工具列表：project-management/references/atlassian-mcp-tools.md。请勿随意臆造工具名称 —— 如果某个功能不在该列表中，则无法通过 MCP 调用。

关键操作（需先通过 mcp__atlassian__getAccessibleAtlassianResources 获取一次 cloudId）：

// 列出空间（MCP 不支持创建空间 —— 见下文）
mcp__atlassian__getConfluenceSpaces (cloudId)
// 在父页面下创建页面 —— 正文必须是 storage-format XHTML 或 ADF 格式，绝不能使用 wiki 标记语言
mcp__atlassian__createConfluencePage (cloudId, space, title="Sprint 42 Notes", parent page id, body="<p>Meeting notes in storage-format XHTML</p>")
// 更新现有页面（先通过 getConfluencePage 获取当前版本，然后提供 version + 1）
mcp__atlassian__updateConfluencePage (cloudId, pageId="789012", version=5, body="<p>Updated content</p>")
// 读取页面（正文 + 当前版本）
mcp__atlassian__getConfluencePage (cloudId, pageId="789012")
// 使用 CQL 搜索
mcp__atlassian__searchConfluenceUsingCql (cloudId, cql='space = "TEAM" AND label = "meeting-notes" ORDER BY lastModified DESC')
// 获取子页面以检查层级结构
mcp__atlassian__getConfluencePageDescendants (cloudId, pageId="123456")
// 评论
mcp__atlassian__getConfluencePageFooterComments / mcp__atlassian__createConfluenceFooterComment (cloudId, pageId)

MCP 不支持的功能 —— 请使用 Web UI 或 REST API：

• 创建/删除空间 $\rightarrow$ Confluence UI Spaces > Create space 或 POST /wiki/api/v2/spaces

• 删除页面 $\rightarrow$ Confluence UI 或 DELETE /wiki/api/v2/pages/{id}

• 应用标签 $\rightarrow$ Confluence UI 或 /wiki/rest/api/content/{id}/label

• 空间权限、作为独立对象的模板/蓝图 $\rightarrow$ Confluence 空间设置 UI

集成点：

• 为高级项目经理（Senior PM）的项目创建文档

• 为 Scrum Master 提供仪式模板支持

• 为 Jira 专家提供 Jira 问题的链接

• 为模板创建者（Template Creator）提供模板

> 另请参阅：references/macro-cheat-sheet.md 查看 storage-format 宏语法，references/templates.md 查看模板库，references/space-architecture-patterns.md 查看空间结构与权限模式。

工作流

空间创建

> MCP 不支持创建空间 —— 请在 Confluence UI (Spaces > Create space) 或通过 REST API (POST /wiki/api/v2/spaces) 创建空间。空间内部的页面树可以通过 MCP 构建 (mcp__atlassian__createConfluencePage)。

0. 根据团队描述生成推荐的层级结构：
`


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

空间主页
├── 概览与入门指南
├── 团队信息
│   ├── 团队成员与角色
│   ├── 沟通渠道
│   └── 协作约定
├── 项目
│   ├── 项目 A
│   │   ├── 概览
│   │   ├── 需求
│   │   └── 会议记录
│   └── 项目 B
├── 流程与工作流
├── 会议记录（存档）
└── 资源与参考资料

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

> 语法说明：下文中的 {macro} 简写为旧版 Wiki 标记法，仅为了易读性而展示。通过 MCP (createConfluencePage / updateConfluencePage) 创建的 Confluence Cloud 页面需要使用 存储格式 (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}
此处填写重要信息
{info}

{expand:title=点击展开}
此处填写隐藏内容
{expand}

{toc:maxLevel=3}

{excerpt}
可复用内容
{excerpt}

{excerpt-include:Page Name}

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

{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}
[ ] 任务 1

[x] 任务 2 已完成

{tasks}

@username

{date:format=dd MMM yyyy}

{section}
{column:width=50%}
左侧内容
{column}
{column:width=50%}
右侧内容
{column}
{section}

{panel:title=面板标题|borderColor=#ccc}
面板内容
{panel}

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

> 包含完整标记的完整模板库：请参阅 references/templates.md。核心模板摘要如下。

> 各空间类型的权限模式：请参阅 references/space-architecture-patterns.md。注意：空间权限在 Confluence UI (空间设置 > 权限) 中配置，而非通过 MCP。

• Jira 专家 (project-management/jira-expert/) — Jira Issue 宏和链接可补充 Confluence 文档

• Atlassian 模板 (project-management/atlassian-templates/`) — 用于创建 Confluence 内容的模板模式