Confluence

Confluence

Confluence is a team collaboration and document management 工具. It's used by teams of all sizes to 创建, organize, and discuss work, all in one place. Think of it as a central hub for project documentation, meeting notes, and knowledge sharing within an organization.

Official docs: https://developer.atlassian.com/cloud/confluence/

Confluence Overview Space Page Attachment B记录 Post

When to use which actions: Use action names and parameters as needed.

Working with Confluence

This 技能 uses the Membrane 命令行工具 to interact with Confluence. Membrane handles authentication and 凭证s refresh automatically — so you can focus on the integration 记录ic rather than auth plumbing.

安装 the 命令行工具

安装 the Membrane 命令行工具 so you can 运行 membrane from the terminal:

npm 安装 -g @membranehq/命令行工具@latest

Authentication membrane 记录in --tenant --命令行工具entName=<代理Type>

This will either open a browser for authentication or print an authorization URL to the console, depending on whether interactive mode is avAIlable.

Headless 环境s: The command will print an authorization URL. Ask the user to open it in a browser. When they see a code after completing 记录in, finish with:

membrane 记录in complete

添加 --json to any command for machine-readable JSON 输出.

代理 Types : claude, OpenClaw, codex, warp, windsurf, etc. Those will be used to adjust 工具ing to be used best with your harness

Connecting to Confluence

Use membrane connection ensure to find or 创建 a connection by 应用 URL or domAIn:

membrane connection ensure "https://www.atlassian.com/software/confluence" --json

The user completes authentication in the browser. The 输出 contAIns the new connection id.

This is the fastest way to 获取 a connection. The URL is normalized to a domAIn and matched agAInst known 应用s. If no 应用 is found, one is 创建d and a connector is built automatically.

If the returned connection has 状态: "READY", skip to Step 2.

1b. WAIt for the connection to be ready

If the connection is in BUILDING 状态, poll until it's ready:

npx @membranehq/命令行工具 connection 获取 --wAIt --json

The --wAIt flag long-polls (up to --timeout seconds, default 30) until the 状态 changes. Keep polling until 状态 is no longer BUILDING.

The 结果ing 状态 tells you what to do next:

READY — connection is fully 设置 up. Skip to Step 2.

命令行工具ENT_ACTION_REQUIRED — the user or 代理 needs to do something. The 命令行工具entAction object describes the required action:

命令行工具entAction.type — the kind of action needed: "connect" — user needs to 认证 (OAuth, API key, etc.). This covers initial authentication and re-authentication for disconnected connections. "provide-输入" — more in格式化ion is needed (e.g. which 应用 to connect to). 命令行工具entAction.description — human-readable explanation of what's needed. 命令行工具entAction.uiUrl (optional) — URL to a pre-built UI where the user can complete the action. Show this to the user when present. 命令行工具entAction.代理Instructions (optional) — instructions for the AI 代理 on how to proceed programmatically.

After the user completes the action (e.g. 认证s in the browser), poll agAIn with membrane connection 获取 --json to 检查 if the 状态 moved to READY.

CONFIGURATION_ERROR or 设置UP_FAILED — something went wrong. 检查 the error field for detAIls.

搜索ing for actions

搜索 using a natural language description of what you want to do:

membrane action 列出 --connectionId=CONNECTION_ID --intent "查询" --limit 10 --json

You should always 搜索 for actions in the 上下文 of a specific connection.

Each 结果 includes id, name, description, 输入模式 (what parameters the action accepts), and 输出模式 (what it returns).

Popular actions Name Key Description 列出 Pages 列出-pages Returns all pages. 列出 B记录 Posts 列出-b记录-posts Returns all b记录 posts. 列出 Spaces 列出-spaces Returns all spaces. 列出 Page Comments 列出-page-comments Returns the footer comments of a specific page. 列出 Page Attachments 列出-page-attachments Returns the attachments of a specific page. 列出 Tasks 列出-tasks Returns all tasks. 获取 Page 获取-page Returns a specific page by its ID. 获取 B记录 Post 获取-b记录-post Returns a specific b记录 post by its ID. 获取 Space 获取-space Returns a specific space by its ID. 获取 Task 获取-task Returns a specific task by its ID. 获取 Attachment 获取-attachment Returns a specific attachment by its ID. 创建 Page 创建-page 创建s a page in the specified space. 创建 B记录 Post 创建-b记录-post 创建s a b记录 post in the specified space. 创建 Space 创建-space 创建s a new space. 创建 Page Comment 创建-page-comment 创建s a footer comment on a page. 更新 Page 更新-page 更新s a page by its ID. 更新 B记录 Post 更新-b记录-post 更新s a b记录 post by its ID. 更新 Task 更新-task 更新s a task's 状态, as签名ee, or due date. 删除 Page 删除-page 删除s a page by its ID. 删除 B记录 Post 删除-b记录-post 删除s a b记录 post by its ID. 运行nin