用途:通过命令行查询、检索与阅读 Confluence 文档/页面,并支持将 Markdown 发布为页面、下载附件。
主要能力:space 子命令可 list、get;page 子命令可 get、by-title、children、rename、publish-markdown;attachment 子命令可 list、download;search 支持 --cql。输出统一在脚本后、子命令前加 --json。
使用方式:以 SKILL.md 所在文件夹为 workdir,直接执行脚本,不要用 uv run python 或 python。示例:cd skills/confluence-cli && ./scripts/confluence_cli.py --json page get --page-id 3060336952。冷门参数可运行 ./scripts/confluence_cli.py <command> --help 查看。
附件下载:可重复传 --name 指定附件,或用 --all 自动分页下载全部,也可用 --filter 正则过滤。发布 Markdown 示例:./scripts/confluence_cli.py --json page publish-markdown --parent-id 3061931928 --title "批量重置 Offset 功能测试" --markdown-path /path/to/doc.md。Markdown 表格支持 :---、:---:、---: 对齐语法;本地图片默认最大宽 1000、最大高 800,可用 --image-max-width / --image-max-height 覆盖,也可用图片 title 指定 confluence-width、confluence-height、confluence-size=original。
限制:page get 默认走普通缓存,刚更新页面后校验正文需加 --fresh 绕过缓存。脚本包含 confluence_cli.py 主入口与 confluence_api_client.py SDK 封装层。其余配置、认证与平台支持等细节暂未提供。