confluence-skill
为Claude Code提供Confluence文档管理的专家级指导与自动化技能
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：confluence-skill。 它的用途是：为Claude Code提供Confluence文档管理的专家级指导与自动化技能 完整的 Skill 内容见：https://321skill.com/skills/confluence-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我把本地的 `api-guide.md` 文档上传到 Confluence 的 DEV 空间，父页面ID是 780369923。’，它会指导你使用 `upload_confluence_v2.py` 脚本，并可能提示你先将文档中的 Mermaid 图表转换为图片。或者说：‘下载ID为123456789的Confluence页面及其所有子页面。’，它会调用 `download_confluence.py` 脚本，将页面树下载为本地Markdown文件。
介绍
Confluence Skill 是一个专为 Claude Code 设计的文档管理工具，旨在解决开发者和技术文档工程师在 Atlassian Confluence 平台上进行高效文档协作时遇到的痛点。它提供了将本地 Markdown 文档与 Confluence 页面进行双向同步、格式转换、图片附件处理以及图表集成的能力。
使用方式非常灵活：对于简单的页面读取和创建，可以直接通过集成的 MCP 工具调用；对于包含大量内容或图片的大型文档上传，则需要使用配套的 Python 脚本（如 upload_confluence_v2.py）通过 REST API 完成，以绕过 MCP 的大小限制。用户还可以使用 download_confluence.py 脚本将 Confluence 页面下载为结构化的 Markdown 文件，便于本地编辑和版本控制。
这个技能非常适合经常使用 Confluence 作为知识库的团队，特别是 DevOps 工程师、技术文档写作者和项目经理。他们需要在本地编写文档、管理图表，并最终发布到 Confluence，或者需要将现有的 Confluence 知识库内容导出进行备份或迁移。
与同类仅提供基础 API 调用的 Confluence 工具相比，这个 Skill 的核心优势在于其‘工作流导向’的设计。它不仅提供了工具，更通过详细的决策矩阵和最佳实践指南，引导用户根据文档大小、是否含图片等具体场景选择最优的自动化路径，实现了从简单的页面更新到复杂的、包含附件的多页面同步的全套解决方案。
核心特点
核心区别在于其‘场景化工作流’与‘大小限制规避’策略。它明确区分了使用 MCP 工具处理小文本和使用独立 REST API 脚本处理大文档/图片的场景，并提供了相应的工具链（如 `upload_confluence_v2.py`）和指南，确保任何规模的文档操作都能可靠完成，而非仅仅提供基础接口。
注意事项
不适合仅需在 Confluence Web 界面进行简单手动编辑，或文档协作流程完全不涉及本地 Markdown 文件的团队。
常见问题
如何上传一个带有图片的大型 Markdown 文档到 Confluence？
使用 `upload_confluence_v2.py` 脚本，它会自动处理图片附件并上传整个文档。
MCP 工具和配套的 Python 脚本有什么区别？
MCP 工具适合快速读取、搜索或创建/更新小文本页面（<10KB）；Python 脚本通过 REST API 工作，无大小限制，适合处理大型文档和图片。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/confluence-skill/raw/index.md 读取 confluence-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/confluence-skill/raw/index.md（查看排版版本）