核心用法
本技能通过 jira-cli 提供完整的 Confluence 页面和空间管理能力,主要功能包括:
- 搜索页面:使用 CQL(Confluence Query Language)查询页面内容
- 查看页面:通过页面 ID 获取详细内容
- 创建/更新页面:支持指定空间、标题和正文内容
- 空间管理:列出所有可访问的 Confluence 空间
显著优点
1. 一体化体验:与 Jira CLI 共用同一套认证配置,无需重复设置
2. 命令行效率:适合快速查询文档、批量操作或集成到 CI/CD 工作流
3. 官方生态支持:基于 Atlassian 官方 API,功能稳定可靠
4. CQL 支持:高级查询语言可实现精准内容检索
潜在缺点与局限性
1. 格式门槛:页面内容需使用 Confluence 存储格式(类 HTML),非 Markdown 原生支持
2. 学习成本:需要理解 CQL 语法和页面 ID 定位机制
3. 权限依赖:受限于 Atlassian 账户的 Confluence 访问权限
4. 功能边界:不支持富媒体上传、页面模板等高级功能
适合人群
- 开发团队需要快速查阅技术文档
- DevOps 工程师将文档管理集成到自动化流程
- 技术写作者批量维护 Confluence 内容
常规风险
- API Token 需妥善保管,避免硬编码提交到代码仓库
- 批量更新操作不可逆,建议先测试单条命令
- 企业网络可能限制对
*.atlassian.net的访问
安全说明
技能文档未提供实际安全扫描结果,认证报告为占位符。实际使用需确保 JIRA_API_TOKEN 通过环境变量安全注入,遵循最小权限原则分配 API Token 范围。