核心用法
Confluence skill 基于开源工具 jira-cli 提供完整的 Confluence 文档管理能力。该工具由 Ankit Pokhrel 开发，采用 Go 语言编写，通过 Atlassian REST API 与 Confluence Cloud/Server 交互。
主要功能模块：
- 搜索功能：
jira confluence search支持 CQL（Confluence Query Language）语法，可精准定位页面内容 - 页面操作：
view命令查看页面详情，create和update支持通过命令行直接管理文档 - 空间管理：
space list快速浏览可用工作空间
认证机制：复用 Jira 的 API Token 认证体系，通过 jira init 一次性配置，降低多工具凭证管理成本。
显著优点
1. 统一 CLI 体验：与 Jira CLI 共享安装包和配置，减少工具链碎片化
2. 批处理能力：适合 CI/CD 流水线中自动更新文档、生成发布说明等场景
3. 开发者友好：纯命令行交互，支持脚本化操作和输出重定向
4. 开源可审计：代码托管于 GitHub，社区驱动更新
潜在局限性
- 格式限制：页面内容需使用 Confluence 存储格式（类 HTML），非 Markdown 原生支持
- 功能边界：不支持富文本编辑器的完整功能（如宏、嵌入动态内容）
- 企业特性：对 Confluence Data Center 部分高级权限管理支持有限
- 学习曲线：CQL 语法需要额外学习成本
适合人群
- 需要批量维护技术文档的 DevOps/平台工程师
- 习惯终端工作流的开发团队
- 寻求文档自动化（如发布流程中文档更新）的组织
常规风险
- 令牌泄露风险：
JIRA_API_TOKEN需妥善保管，避免提交至代码仓库 - 误操作覆盖：
update命令直接覆盖内容，无版本对比确认环节 - 权限扩散：API Token 通常拥有读写权限，需遵循最小权限原则