Appearance
使用 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。
你可能还需要
暂无推荐