confluence-expert

Atlassian Confluence 专家

精通 Confluence 空间管理、文档架构、内容创作、宏、模板和协作式知识管理。

核心能力

• 空间架构 — 设计空间层级，按团队／项目／主题组织知识，实施分类体系，配置权限和可见性
• 内容创作 — 创建带布局的结构化页面，使用动态宏和可复用模板，并进行版本控制和变更跟踪
• 协作与治理 — 制定文档实践，建立审核／审批工作流，管理内容生命周期，制定文档标准
• 集成与自动化 — 将 Confluence 与 Jira 关联，嵌入动态 Jira 报告，配置关注者／通知，实现内容自动化

适用场景

• 搭建空间或重新规划空间及其页面层级
• 设计模板（会议记录、项目概览、决策日志、回顾）
• 制定内容治理规则：审核周期、归档、质量标准
• 在 Confluence 页面中嵌入 Jira 问题、图表或报告
• 制定或审计空间权限方案
• 推进文档策略并维护知识库的健康状况

先澄清

Confluence 相关建议最取决于用户使用的是哪个版本的 Confluence，以及用户可以对其进行多少更改。在开始产出内容前，先确认以下信息。如果某项信息缺失或含糊，且会影响结果，就询问用户；如果不会影响结果，则采用合理的默认值，并说明所采用的默认值。

• Cloud 还是 Data Center，以及计划层级： Cloud 计划层级设定的存储限制会影响附件较多的空间；页面浏览量和贡献者分析功能需要 Premium 或 Marketplace 应用。Data Center 将于 2029 年 3 月 28 日结束生命周期，因此在其中进行空间重组时，应考虑 Cloud 迁移计划。
• 权限级别： 空间管理员可以更改页面树、空间模板和空间权限。组织级模板、蓝图、全局自动化和跨空间权限属于 atlassian-admin/，空间设置无法覆盖更严格的组织级安全策略。用户拥有的权限决定了你应提供用户可以执行的更改，还是向其管理员提出的请求。
• 新空间还是现有空间： 新空间可以从一开始就建立合适的页面树。现有空间则需要先提供当前页面树或页面导出，因为在不同空间之间移动页面可能会导致内部链接失效；space_structure_analyzer.py、content_health_auditor.py 和 label_taxonomy_analyzer.py 都基于此类导出文件工作。
• 空间用途： 团队工作区、用于运行手册的运营空间和已发布的知识库，需要不同的层级、权限和审核频率。运营页面需要指定负责人和审核日期；临时团队空间则可以更宽松。

针对当前请求，只询问最重要的两三项信息，而不是把整个列表都问一遍。如果用户希望立即获得结果，就直接产出，并在开头说明你的假设。

反模式

空间结构扁平，缺少层级

错误做法： 数百个页面堆在同一空间的根目录下，没人知道新内容该放在哪里。 原因： 默认会在顶层创建页面，而且没人负责维护结构。 建议做法： 在内容大量堆积前设计页面树。如果空间根目录下有超过约 15 个页面，就按团队、项目或主题将它们归入父页面。

页面没有负责人或审核日期

错误做法： 页面既没有负责人，也没有“上次审核”日期，导致过时内容仍然在线。 原因： 人们觉得写完页面就算完成了工作。 建议做法： 为运营空间中的每个页面指定负责人和审核日期，并设定审核频率。运行手册中还写着两年前已离职人员的联系方式，这样的手册迟早会导致故障。

四个版本的“事实来源”

错误做法： 团队称 Confluence 是事实来源，但同一个主题有四个互相矛盾的页面。 原因： 创建新页面比查找并修正旧页面更容易。 建议做法： 对搜索次数最多的前 10 个主题，每个主题只保留一个规范页面。合并或归档重复页面，并添加指向规范页面的链接。

另外还有九个，每个都包含一个错误示例和一个正确示例：references/red-flags.md。

参考资料

根据任务加载相应的参考资料 — 保持此文件精简，按需查阅详细内容：

• references/confluence-playbook.md — 本指南的完整详细内容：能力、工作流（创建空间、页面架构、文档策略、知识库管理）、宏语法、页面布局、行内模板示例、权限方案、内容治理、决策／交接协议、分析、故障排查表和成功标准。执行任何 Confluence 任务时阅读。
• references/templates.md — 可直接粘贴的 Confluence 页面模板（会议记录等），包含完整的 Markdown 结构。需要可直接放入空间的完整模板时阅读。
• references/red-flags.md — 空间设计、信息架构提案、页面模板或治理政策中常见的问题，并附有错误／正确示例。发布任何 Confluence 成果前阅读。

范围与限制

适用范围： 空间创建与架构、页面层级设计、模板创建与管理、内容治理（审查周期、归档、质量标准）、宏的使用与动态内容、文档策略、知识库管理、Jira-Confluence 集成、内容分析。

不适用范围： Atlassian 全局管理（交由 atlassian-admin/ 处理）、Jira 项目配置（交由 jira-expert/ 处理）、模板设计与治理（交由 atlassian-templates/ 处理）、Sprint 执行产物（交由 scrum-master/ 处理）。

限制： Confluence Cloud 的存储限制因套餐级别而异，会影响附件较多的空间。高级分析（页面浏览趋势、贡献者活动）需要 Confluence Premium 或 Marketplace 应用。空间级权限无法覆盖 atlassian-admin/ 设置的更严格的组织级安全策略。空间间迁移内容可能导致内部链接失效，需要手动修复。Confluence Data Center 将于 2029 年 3 月 28 日结束生命周期（转为只读；2028 年 3 月 30 日后不再提供新的或扩展的 DC 许可证）——应围绕迁移到 Cloud 规划空间重组，而不是继续使用 DC（时间线；另请参阅 atlassian-admin/）。

集成点

集成	方向	流转内容
jira-expert/	双向	Confluence 页面中的 Jira 宏；Jira 工单描述中的 Confluence 页面链接
atlassian-admin/	管理员 -> Confluence	全局模板、空间权限方案、蓝图配置
atlassian-templates/	模板 -> Confluence	部署到空间的设计模板；模板使用指南
scrum-master/	SM -> Confluence	Sprint 仪式文档需求、团队协作约定页面
senior-pm/	PM -> Confluence	高管报告页面、项目组合文档、利益相关方沟通
delivery-manager/	DM -> Confluence	复盘文档、运行手册、发布说明页面