SuperAPI AI 工具集

twg-confluence

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:配合根命令 twg 使用,当 Confluence 是主要数据来源或修改目标时处理内容与空间操作,涵盖内容、空间、层级、创作、编辑、评论、版本、权限、导出与 CQL 查询。该技能负责内容类型、层级、格式与并发语义,具体命令语法以实时帮助为准。

主要入口:已知内容 ID 或 URL 用 confluence content get;多个已知页面用一次 docs get <id-or-url…>;精确过滤用 confluence search 配合 CQL;按日期过滤的页面/博客列表用 confluence search query --cql 配合 lastmodified(content list 无日期过滤);模糊发现用跨产品搜索后再原生获取;创建或更新走统一 confluence content 界面;空间元数据用 confluence space;层级用 confluence tree;导出中 Word 直接返回下载,PDF 需轮询导出状态。不熟悉的修改前先用 twg help describe "<exact path>"。

用法要点:搜索片段仅作发现候选,摘要或编辑前需读取所选内容。confluence content get 与 content versions list --id 为单页操作;处理页面集时先用一次 confluence search query --cql 取元数据,再仅对影响答案的页面用 docs get 批量补充正文,避免对页面列表循环调用单页路由或逐页重跑 CQL。页面标题单独提供,不要在正文首行重复标题。

安全与限制:归档、回收站和彻底删除需区分用户授权与 CLI 确认,--yes 只是执行预检而非授权凭证,仅在用户明确指定操作和目标后使用。模糊表述不构成授权;推断出的操作需先呈现目标并等待确认。创建前按空间应用指令(见 references/spaces.md),优先使用 live_doc,经典页面用于明确意图或既有经典空间;非平凡编辑先读取内容、本地保存、编辑后带快照令牌更新,宏或精确存储格式用无损 HTML 往返。变更后回读并报告 URL。

该公司未提供具体价格、平台支持或效果数据;auth 或命令错误不应误判为 PATH 问题。可移交 twg-context-discovery、twg-responsibility-routing、twg-status-rollups、twg-operational-health、twg-space-creation 等技能。