用途:这是 Confluence Assistant 的运维类技能,负责 Confluence 集成的运行维护,包括缓存监控与管理、API 连通性诊断、性能优化和速率限制排障。页面、搜索、空间等业务操作应使用 confluence-page、confluence-search、confluence-space 等对应技能。
主要能力:查看缓存统计(条目数、大小、命中率、分类明细);预热缓存(空间列表、指定空间元数据或全部元数据);清理缓存(全部、按分类、按模式、按天数,支持 dry-run 预览);健康检查与 API 诊断(测试端点、响应时间、认证状态);查看速率限制状态。缓存分类含 spaces、pages、users、search、labels、permissions,各有默认 TTL。
使用方式:通过 CLI 调用,例如 confluence ops cache-status、confluence ops cache-clear --force、confluence ops cache-warm --spaces、confluence ops health-check、confluence ops api-diagnostics、confluence ops rate-limit-status,多数命令支持 --output json 与 --verbose。缓存默认存于 ~/.confluence-skills/cache/,可用 CONFLUENCE_CACHE_DIR、CONFLUENCE_CACHE_ENABLED、CONFLUENCE_CACHE_TTL 环境变量配置。
适用场景:缓存命中率低于 50%、API 响应超过 2 秒、新实例初始化、批量操作前预热、空间变更后失效缓存、排查 429 错误。
限制:cache-clear 会移除缓存并可能拖慢后续请求,属风险操作;Confluence Cloud 不在响应头暴露速率限制信息,需自行监控 429 并采用退避重试。退出码 0 成功、1 一般错误、2 配置错误、3 缓存数据库错误、4 网络错误。具体收费与平台支持资料暂未提供。