SuperAPI AI 工具集

confluence

办公与效率

查看项目

更新于 10-15 17:18

技能介绍

用途:通过脚本与 Confluence 交互,进行内容搜索、页面查看与空间管理,适合在代理环境中处理 Confluence 文档。

主要能力:使用 CQL 搜索内容;按标题或 ID 获取页面(默认输出 Markdown,可导出文件并下载图片);查看页面版本历史;创建与更新页面(支持 Markdown、图片、frontmatter、目录和内部链接,详见 references/creating-content.md);移动或删除页面;列出和查看空间;查看、添加、删除空间权限;查看配置与默认值。

安装与验证:依赖 pip install --user requests keyring pyyaml。设置 SKILL_DIR 为包含 SKILL.md 的绝对路径后,运行 $SKILL_DIR/scripts/confluence.py check 检查依赖、认证和连通性。

认证:可用环境变量 CONFLUENCE_URL、CONFLUENCE_EMAIL、CONFLUENCE_API_TOKEN,或配置文件 ~/.config/agent-skills/confluence.yaml(url、email、token,可选 defaults 如 cql_scope、max_results、default_space)。API Token 在 Atlassian 账户安全页创建。

常用命令:search、page get/history/create/update/move/delete、space list/get、space permissions list/add/remove、config show。命令读写分类见 permissions.md。

限制:远程操作需要出站 HTTPS 访问配置的 Confluence 主机;技能说明不授予网络权限,受限环境需预先获得审批。DNS、连接、超时失败应报告为网络错误,不要重置凭据;认证与权限错误需用户处理。标准能力模型即可满足结构化输入输出需求。其余细节暂未提供。