Atlassian Confluence Expert 是一项面向 Confluence 的专家级技能，聚焦空间管理、文档架构、内容创建、宏、模板与协作式知识管理。
用途与集成 该技能的主要工具是 Atlassian Remote MCP 服务器（内置 .mcp.json，server key 为 atlassian）。工具名采用 camelCase，呈现为 mcp__atlassian__<toolName>。规范的工具列表见 project-management/references/atlassian-mcp-tools.md；不应虚构工具名——如果某个能力不在此列表中，则 MCP 不支持。关键操作前需先通过 mcp__atlassian__getAccessibleAtlassianResources 获取一次 cloudId。
主要能力（通过 MCP）
- 列出空间：mcp__atlassian__getConfluenceSpaces
- 在父页面下创建页面：mcp__atlassian__createConfluencePage，正文必须为 storage 格式 XHTML 或 ADF，绝不使用 wiki markup
- 更新页面：先用 getConfluencePage 获取当前版本，再提供 version + 1
- 读取页面：mcp__atlassian__getConfluencePage
- 使用 CQL 搜索：mcp__atlassian__searchConfluenceUsingCql
- 获取子页面以检查层级：mcp__atlassian__getConfluencePageDescendants
- 评论：mcp__atlassian__getConfluencePageFooterComments / mcp__atlassian__createConfluenceFooterComment
MCP 不支持、需用 Web 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
工作流 空间创建：空间创建无法通过 MCP 完成，需在 Confluence UI 或通过 REST 创建；其内部页面树可通过 MCP 构建。可先用 python3 scripts/space_structure_generator.py team_info.json --format json 根据团队描述生成推荐层级，输出可作为创建计划，每个节点调用一次 createConfluencePage 并传递父页面 id 来嵌套子页面。随后确定空间类型、设置首页、配置权限、创建初始页面树、添加空间快捷方式并验证。
页面架构：使用父子层级，导航最多三层，命名一致，会议记录标注日期。推荐结构包含空间首页、概述与入门、团队信息、项目、流程与工作流、会议记录存档、资源与参考。
模板创建：识别可重复内容模式，创建带占位符和说明的页面，使用合适宏格式化，保存为模板，在空间或全局共享，并先验证占位符渲染。
文档策略与知识库管理：评估现状、定义目标与受众、组织分类结构、创建模板与指南、迁移现有文档、培训团队并监控采用情况。内容健康审计可运行 python3 scripts/content_audit_analyzer.py pages.json --format json，输入页面清单 JSON，输出过时/孤立/低参与度发现，作为归档清单和更新待办。
宏与模板 内容宏包括 info、note、warning、tip、expand、toc、excerpt、excerpt-include；动态内容宏包括 jira、jirachart、recently-updated、contentbylabel；协作宏包括 status、tasks、用户提及、日期；布局与格式化宏包括 section/column、panel、code。注意 {macro} 简写仅为便于阅读的旧 wiki 标记，通过 MCP 创建的页面需 storage 格式（XHTML），详见 references/macro-cheat-sheet.md。模板库见 references/templates.md，关键模板包括会议记录、项目概览、决策日志、冲刺回顾。
权限与治理 权限方案按空间类型区分：公共空间、团队空间、项目空间。内容治理包含审查周期（关键文档每月、标准文档每季度、存档文档每年）、归档策略（移入 Archive 空间、打标签、保留 2 年、保留审计轨迹）和内容质量清单。
适用场景与协作 适用于为高级 PM 项目创建文档、支持 Scrum Master 的仪式模板、与 Jira Expert 链接 Jira 问题、为 Template Creator 提供模板。当需要组织级模板、跨空间权限、蓝图配置、全局自动化规则或空间导入导出时，升级至 Atlassian Admin。
限制 空间创建、页面删除、标签应用、空间权限与模板等第一类对象无法通过 MCP 完成，需使用 Confluence UI 或 REST API。正文必须为 storage 格式 XHTML 或 ADF，不能使用 wiki markup。不应虚构 MCP 工具名。其余能力细节以资料为准，未提供的部分暂未提供。