Skip to content

使用 AI 自动化管理 Confluence 页面与知识库

解决知识库手动维护低效的问题:通过连接 Rube MCP,让 AI 能够自动执行 Confluence 的页面创建、CQL 高级搜索、空间管理及标签维护等复杂操作。

为什么需要这个技能

在大型企业知识库中,手动创建页面、分类文档、搜索历史信息往往非常耗时。特别是当需要批量更新文档版本或维护复杂的页面层级时,重复性工作极多。

通过本技能,AI 可以直接调用 Confluence 的 API 接口,实现从“搜索现有内容 确定层级 编写 XHTML 内容 自动发布/更新”的完整闭环,将文档维护工作从手动操作转变为指令驱动。

适用场景

  • 文档自动生成:将 AI 生成的技术方案或会议纪要直接创建为 Confluence 页面。
  • 知识检索与汇总:使用 CQL(Confluence Query Language)在海量空间中快速定位相关文档。
  • 知识库结构优化:自动整理页面层级,为页面批量添加标签(Labels)以方便分类。
  • 版本同步更新:在不破坏原文档结构的情况下,自动更新现有页面的特定章节。

核心工作流

1. 页面创建与更新

  • 定位空间:调用 CONFLUENCE_GET_SPACES 获取目标空间的 ID。
  • 冲突检查:使用 CONFLUENCE_SEARCH_CONTENT 检查标题是否重复。
  • 执行操作
    • 创建:调用 CONFLUENCE_CREATE_PAGE,注意内容必须为 XHTML 格式。
    • 更新:先用 CONFLUENCE_GET_PAGE_BY_ID 获取当前版本号,然后在 CONFLUENCE_UPDATE_PAGE 中将版本号设置为 current + 1

2. 高级内容搜索

  • 基础搜索:使用 CONFLUENCE_SEARCH_CONTENT 进行关键词匹配。
  • 精准检索:使用 CONFLUENCE_CQL_SEARCH 编写 CQL 语句(例如:text ~ "API" AND space = DOCS)实现多维度过滤。

3. 空间与层级管理

  • 空间操作:通过 CONFLUENCE_CREATE_SPACE 建立新项目空间。
  • 层级导航:利用 CONFLUENCE_GET_CHILD_PAGES 递归获取页面树结构,或使用 CONFLUENCE_GET_PAGE_ANCESTORS 追溯父级路径。

注意事项(坑点)

  • 格式要求:Confluence 不支持直接写入 Markdown,必须转换为 XHTML 存储格式(如使用 <p><table> 等标签)。
  • ID 区分Space Key(如 DOCS)和 Space ID(数字)在不同接口中要求不同,调用前需确认。
  • 频率限制:搜索接口可能触发 HTTP 429 错误,建议在自动化脚本中加入指数退避重试机制。

下载和安装

下载 confluence-automation 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md

你可能还需要

暂无推荐