Confluence 技能为 Golden Armada AI Agent Fleet Platform 提供较完整的 Confluence 文档处理能力,目标是帮助在 Confluence 中创建与维护文档页面、空间和知识库。
【用途】 当工作涉及文档页面、空间管理、模板与蓝图、知识库创建,或 Confluence API 集成时,可激活该技能。它适用于 wiki 页面维护、文档编写和团队知识库建设等场景。
【主要能力】 该技能围绕 Confluence API 展开,提供以下快速参考:
- 身份认证:通过 atlassian 库的 Confluence 类,使用 URL、用户名(邮箱)、密码(API_TOKEN)及 cloud=True 进行连接。
- 页面操作:创建页面(可指定 space、title、body、可选 parent_id)、按标题获取页面、按 ID 获取页面(可展开 body.storage、version)、更新页面、删除页面,以及获取页面内容(通过 expand='body.storage' 读取 HTML 内容)。
- 空间操作:创建空间(space_key、space_name、description)、获取空间(可展开 homepage)、获取空间内所有页面(可设置 start、limit、expand)。
- 搜索:支持 CQL 搜索(如 space = GA AND type = page AND text ~ "agent")和按查询、空间、类型搜索页面。
- 页面模板:提供架构文档、API 文档、会议记录等模板示例,使用 Confluence 结构化宏(如 toc、code、expand、info、placeholder)。
- 宏参考:列出常用宏,包括 toc、code、info、warning、expand、status、jira 等及其参数写法。
- Golden Armada 命令:提供文档发布、页面更新、文档同步的命令示例,如 /confluence-publish、/confluence-update、/atlassian-sync。
【使用方式】 资料给出的是 Python 代码示例与命令行示例。使用前需安装并引入 atlassian 库中的 Confluence,并配置 URL、用户名与 API_TOKEN。页面与空间操作通过对应方法调用完成,内容以 body.storage 形式读写,模板与宏以 HTML/结构化宏形式嵌入页面。具体安装命令资料中未提供。
【适用场景】 适合需要批量或程序化管理 Confluence 内容的场景,例如创建架构文档、编写 API 文档、记录会议纪要、维护团队知识库、按空间整理页面层级,以及通过 CQL 检索特定页面。
【限制与缺失信息】 资料未说明支持的 Confluence 版本、部署类型(云或本地)以外的限制、权限要求、速率限制、错误处理方式,也未提供收费、价格、平台支持范围等信息。部分模板与宏示例在原始资料中存在标签闭合不完整的情况,实际使用时需按 Confluence 规范补全。