Confluence

核心用法

本技能通过 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 范围。

核心用法

本 Skill 是一个纯 Markdown 格式的操作指南包装器，本身无可执行代码，核心功能依赖于外部 CLI 工具 jira-cli（ankitpokhrel/jira-cli）。用户需先完成四步初始化：安装 CLI、获取 Atlassian API Token、配置 CLI（jira init）、验证连接。配置完成后，即可通过命令行实现对 Confluence 空间的全面管理：搜索页面（jira confluence search）、查看页面详情（jira confluence view）、创建新页面（jira confluence create）、更新现有页面（jira confluence update）以及列出所有空间（jira confluence space list）。由于 Jira 和 Confluence 共享同一套 API Token 和认证体系，已配置 Jira 的用户可直接无缝使用 Confluence 功能。

显著优点

零代码风险：本 Skill 为纯文档型包装器，不含任何可执行代码块，从根本上杜绝了恶意代码注入风险。成熟依赖生态：底层依赖的 jira-cli 是 GitHub 上高度成熟的开源项目，拥有 5879 stars，创建于 2020 年，社区活跃且维护良好。企业级兼容：直接对接 Atlassian 官方 API，与 Confluence Cloud 原生深度集成，支持 CQL（Confluence Query Language）高级搜索语法。配置复用：与 Jira 技能共享同一套认证体系，降低多工具管理成本。格式灵活：支持 Confluence 存储格式（类 HTML），便于迁移和批量处理富文本内容。

潜在缺点与局限性

外部依赖性强：核心功能完全依赖用户本地安装的 jira-cli 工具，若用户环境未正确配置或 CLI 版本过旧，将导致技能失效。格式学习成本：Confluence 存储格式与 Markdown 有差异，创建/更新页面时需适应其类 HTML 语法。网络环境要求：必须能够稳定访问 atlassian.net 域名，企业内网或受限网络环境可能受阻。无可视化界面：纯命令行交互方式，对非技术背景用户不够友好。权限边界依赖：实际数据访问权限由 Atlassian 账户的 Space 权限控制，Skill 本身不做额外权限校验。

适合的目标群体

• 技术团队/DevOps 工程师：习惯命令行操作，需要批量管理文档或集成到 CI/CD 流程
• 知识库管理员：负责企业 Wiki 维护，需要高效搜索、整理大量页面内容
• 项目经理/产品经理：需要快速查阅项目文档、创建会议纪要或产品规范
• 全栈开发者：同时管理 Jira 任务和 Confluence 文档，追求工具链统一

使用风险

配置风险：API Token 若未妥善存储（如误提交到代码仓库）可能导致企业数据泄露，需严格使用环境变量管理。依赖更新风险：jira-cli 的安全更新需用户主动跟进，建议定期通过 brew upgrade 保持最新。性能瓶颈：大规模空间搜索或批量操作时，受 Atlassian API 速率限制影响，可能出现延迟。数据一致性：网络中断时可能导致页面更新操作未完成，建议在关键编辑后手动验证。供应链信任：虽然当前依赖来源可信（T2 级别），但仍建议关注 jira-cli 项目的安全公告。