SuperAPI AI 工具集

publish-to-confluence

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:将 vault 中的 Markdown 文档发布到 Confluence,支持新建页面或更新已有页面,适用于把 PRD、发布说明等文档同步到团队 wiki。触发方式为用户要求发布到 Confluence,或执行命令 /publish-to-confluence。

主要能力:识别源文档(指定路径、按描述搜索 04-projects/、05-knowledge/、01-daily/ 等目录,或使用刚生成的文档);配置目标空间键、父页面、页面标题、标签和发布模式;将 Markdown 转换为 Confluence 存储格式(XHTML),涵盖标题、加粗斜体、列表、链接、行内代码、代码块、表格、引用、分隔线、任务列表等,并剥离 YAML frontmatter、把 vault 相对链接转为纯文本;发布前展示摘要与内容预览,等待用户明确确认后才发布;成功后输出页面 URL、空间与版本号,并将 confluence_url、confluence_page_id、confluence_space、published_at、confluence_version 写回源文件 frontmatter;对已发布文档提供更新(递增版本)、新建副本或取消选项。

使用方式:先做预检,读取 00-inbox/MY-INTEGRATIONS.md,确认 Confluence 在 Active Integrations 中,否则提示用户并停止;Confluence 被禁用时静默跳过并建议替代平台(如 HackMD、Notion)。用 Bash 执行 date '+%Y-%m-%d %H:%M' 获取时间戳。若不知空间或父页面,可用 WebFetch 调用 GET /wiki/rest/api/space?limit=50 和 GET /wiki/rest/api/content?spaceKey=[SPACE]&type=page&limit=25 查询。发布时通过 Confluence REST API:新建用 POST .../wiki/rest/api/content,更新先 GET .../wiki/rest/api/content/[PAGE_ID]?expand=version 再 PUT。

限制:必须获得用户显式批准,绝不自动发布;需要已配置的 Confluence 凭据与写入权限。API 错误包括 403 权限不足、404 空间键或父页面 ID 错误、409 页面被他人修改(需取最新版本重试)、限流需退避重试、网络错误时把转换后内容保存到本地。API 失败时保存转换后的 XHTML 供手动粘贴;认证失败提示刷新凭据;同名页面需询问更新、改用其他标题或取消;超大文档提示拆分;不支持的 Markdown 元素尽力转换并警告。具体 Confluence 地址、空间键等需自行配置,资料未提供固定值。