菜单
Confluence CLI commands — search pages, get page content, create/update pages, add comments, download attachments. Use for any Confluence task.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Jira CLI commands — search issues, get issue details, create/update issues, add comments, transition issues. Use for any Jira task.
CLI for Atlassian Jira and Confluence — search, read, create, update issues and pages. Use atl for any request involving Jira or Confluence. Works with both Cloud and Server/Data Center deployments.
| name | atl-confluence |
| description | Confluence CLI commands — search pages, get page content, create/update pages, add comments, download attachments. Use for any Confluence task. |
| allowed-tools | Bash(atl:*) |
# Search pages
atl confluence search "deployment guide"
# Read a page
atl confluence get-page --id 12345
# Create a page
atl confluence create-page --space DEV --title "New Guide" --body "# Hello\n\nContent here"
# Update a page
atl confluence update-page --id 12345 --body "# Updated content"
# Add a comment
atl confluence add-comment "Looks good!" --page-id 12345
atl confluence search <query>Search Confluence pages. Accepts plain text (auto-converted to CQL) or raw CQL queries.
atl confluence search "<query>" [--limit N] [--offset N] [--spaces SPACE1,SPACE2] [--json]
Options:
--limit N (default: 10) — max results--offset N (default: 0) — skip N results--spaces — comma-separated space keys to filter--json — force JSON outputExamples:
atl confluence search "deployment guide"
atl confluence search "type = page AND space = DEV AND title ~ 'API'"
atl confluence search "architecture" --spaces DEV,PLATFORM
JSON output:
{
"results": [
{
"id": "12345",
"title": "Page Title",
"type": "page",
"spaceKey": "DEV",
"spaceName": "Development",
"lastModified": "2024-01-16T14:20:00.000Z",
"excerpt": "Matching excerpt...",
"url": "https://company.atlassian.net/wiki/spaces/DEV/pages/12345"
}
],
"total": 15,
"hasMore": true
}
atl confluence get-pageGet full page content, converted to layout-aware markdown. Handles multi-column layouts, code blocks, panels, expand sections, and embedded images.
atl confluence get-page --id <PAGE_ID> [--raw] [--json]
atl confluence get-page --title "<title>" --space <KEY> [--raw] [--json]
Options:
--id — page ID (numeric)--title — page title (requires --space)--space — space key (requires --title)--raw — return raw HTML instead of markdown--json — force JSON outputExamples:
atl confluence get-page --id 12345
atl confluence get-page --title "API Documentation" --space DEV
JSON output:
{
"id": "12345",
"title": "API Documentation",
"spaceKey": "DEV",
"spaceName": "Development",
"body": "# API Documentation\n\nPage content in markdown...",
"images": [
{
"filename": "diagram.png",
"url": "https://confluence.example.com/download/attachments/12345/diagram.png",
"mediaType": "image/png",
"fileSize": 245760
}
],
"attachments": [
{
"id": "att67890",
"title": "diagram.png",
"mediaType": "image/png",
"fileSize": 245760,
"downloadUrl": "https://confluence.example.com/download/attachments/12345/diagram.png"
}
],
"version": 5,
"lastModified": "2024-01-16T14:20:00.000Z",
"lastModifiedBy": "John Doe",
"url": "https://company.atlassian.net/wiki/spaces/DEV/pages/12345"
}
atl confluence download-attachmentsDownload attachments from a Confluence page to a local directory.
atl confluence download-attachments --page-id <ID> [--output-dir <dir>] [--filter <type>] [--json]
Options:
--page-id — (required) page ID--output-dir — output directory (default: system temp dir)--filter — images, documents, or all (default: all)Examples:
atl confluence download-attachments --page-id 12345 --filter images
atl confluence download-attachments --page-id 12345 --output-dir ./assets
JSON output:
{
"pageId": "12345",
"outputDir": "/tmp/confluence-attachments/12345",
"downloaded": [
{
"filename": "diagram.png",
"path": "/tmp/confluence-attachments/12345/diagram.png",
"mediaType": "application/octet-stream",
"fileSize": 245760
}
]
}
atl confluence create-pageCreate a new Confluence page.
atl confluence create-page --space <KEY> --title <title> --body <content> [options] [--json]
Required options:
-s, --space <key> — space key--title <title> — page title-b, --body <content> — page body (use - to read from stdin)Optional:
--parent-id <id> — parent page ID--format <format> — markdown (default) or storage (raw Confluence XHTML)Examples:
atl confluence create-page --space DEV --title "API Guide" --body "# API Guide\n\nEndpoints..."
atl confluence create-page -s DEV --title "Sub Page" -b "Content" --parent-id 12345
cat README.md | atl confluence create-page -s DEV --title "README" -b -
atl confluence create-page -s DEV --title "Raw" -b "<h1>Hello</h1><p>World</p>" --format storage
JSON output:
{
"id": "12346",
"title": "API Guide",
"version": 1,
"url": "https://company.atlassian.net/wiki/spaces/DEV/pages/12346"
}
atl confluence update-pageUpdate an existing Confluence page. Auto-detects current version if not specified.
atl confluence update-page --id <pageId> --body <content> [options] [--json]
Required options:
--id <pageId> — page ID-b, --body <content> — new body (use - to read from stdin)Optional:
--title <title> — new page title--format <format> — markdown (default) or storage--version <n> — version number (auto-detected if omitted)Examples:
atl confluence update-page --id 12345 --body "# Updated\n\nNew content"
atl confluence update-page --id 12345 --title "New Title" --body "Content"
cat doc.md | atl confluence update-page --id 12345 -b -
JSON output:
{
"id": "12345",
"title": "Updated Page",
"version": 6,
"url": "https://company.atlassian.net/wiki/spaces/DEV/pages/12345"
}
atl confluence add-comment <body>Add a comment to a Confluence page. Use - as body to read from stdin.
atl confluence add-comment <body> --page-id <id> [--parent-comment-id <id>] [--json]
Options:
--page-id <id> — (required) page ID--parent-comment-id <id> — parent comment ID (for threaded replies)Examples:
atl confluence add-comment "Great documentation!" --page-id 12345
atl confluence add-comment "Reply to this" --page-id 12345 --parent-comment-id 67890
echo "Long comment..." | atl confluence add-comment - --page-id 12345
JSON output:
{
"id": "99001",
"body": "Great documentation!",
"author": "John Doe",
"created": "2024-01-16T14:20:00.000Z"
}
atl confluence get-page --id <ID> --jsonimages array. If empty, summarize from text alone.atl confluence download-attachments --page-id <ID> --filter images --json# 1. Create the page
atl confluence create-page -s DEV --title "Sprint 42 Retrospective" --body "# Sprint 42 Retro" --json
# 2. Update with full content
cat retro-notes.md | atl confluence update-page --id <PAGE_ID> -b -
# 3. Add a comment
atl confluence add-comment "Notes from today's meeting" --page-id <PAGE_ID>