Confluence

核心用法

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 通常拥有读写权限，需遵循最小权限原则

核心用法

本 Skill 是知名开源工具 jira-cli 的 Confluence 功能封装，通过命令行实现完整的文档生命周期管理：

基础操作

• jira confluence search <关键词> - CQL 语法全文搜索
• jira confluence view <page-id> - 提取页面内容（ID 可从 URL /pages/123456 获取）
• jira confluence create --space SPACE --title "..." --body "..." - 创建新页面
• jira confluence update <page-id> --body "..." - 增量更新内容
• jira confluence space list - 浏览可用空间

认证配置
与 Jira 共享 JIRA_API_TOKEN，通过 jira init 一次性初始化，无需额外配置。

显著优点

1. 零代码风险：纯 Markdown 文档型 Skill，无 eval/exec/system 等危险函数，静态/动态分析双满分
2. 来源可信：依赖 ankitpokhrel/jira-cli（GitHub 2k+ stars，Homebrew 官方渠道分发），维护者为可信开发者
3. 工作流整合：同一工具管理 Jira + Confluence，减少上下文切换
4. 格式原生：直接输出 Confluence Storage Format（类 HTML），保留原有富文本结构

局限性与注意事项

• 格式门槛：页面内容需使用 Confluence Storage Format，非 Markdown/WYSIWYG，学习成本较高
• 功能边界：仅覆盖核心 CRUD，不支持页面权限管理、版本对比、附件上传等高级功能
• 依赖外部工具：需预先安装 jira-cli（约 15MB），Windows 用户需手动配置
• 搜索限制：CQL 语法与原生 Confluence 高级搜索存在差异，复杂查询需参考 Atlassian 文档

适合人群

• DevOps/SRE 团队：快速检索运维手册、部署指南
• 技术写作者：批量创建标准化文档模板
• 项目经理：自动化生成会议纪要、周报归档
• CLI 重度用户：偏好键盘驱动的高效知识库导航

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 代码执行 | 🟢 无 | 无可执行代码，纯文档说明 |

| 数据泄露 | 🟢 低 | 需妥善保管 `JIRA_API_TOKEN`，避免提交至版本控制 |

| 供应链攻击 | 🟢 低 | 依赖 Homebrew 官方渠道，建议启用 `HOMEBREW_NO_INSECURE_REDIRECT` |

| 误操作覆盖 | 🟡 中 | `update` 命令直接覆盖内容，建议操作前先用 `view` 确认 |

合规认证：通过 GDPR/CCPA/权限最小化/开源透明度全部 6 项合规检查，证书编号 CLS-2026-0703-CFL-001。