菜单
JIRA integration - embed issues, create links between products. ALWAYS use when user wants to connect Confluence and JIRA.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
View analytics, statistics, and popularity metrics for Confluence content. ALWAYS use when user wants to see views, popularity, or contributor stats.
Manage file attachments - upload, download, list, and delete attachments. ALWAYS use when user wants to work with files on pages.
Manage comments on Confluence pages - add, get, update, delete, and resolve comments. ALWAYS use for feedback, discussions, and inline annotations.
Navigate and manage Confluence page hierarchies, ancestors, descendants, and trees. ALWAYS use for parent/child relationships and page tree navigation.
Manage content labels - add, remove, and search by labels. ALWAYS use when user wants to tag, label, or categorize content.
Manage Confluence pages and blog posts - create, read, update, delete, copy, move, and version control. ALWAYS use when user wants to work with page content, create pages, update pages, or manage page versions.
| name | confluence-jira |
| description | JIRA integration - embed issues, create links between products. ALWAYS use when user wants to connect Confluence and JIRA. |
| triggers | ["jira","embed issue","link jira","jira macro","jira issues","jira link"] |
Cross-product JIRA integration for Confluence.
This skill connects Confluence and JIRA. Use for:
| Use This Skill | Use Instead |
|---|---|
| Embed JIRA issues | - |
| Add JIRA macro | - |
| Link to JIRA | - |
| Create JIRA issues | Use JIRA directly |
| Edit page content | confluence-page |
| Operation | Risk | Notes |
|---|---|---|
| Embed issues | ⚠️ | Modifies page content |
| Add JIRA macro | ⚠️ | Modifies page content |
| Link to JIRA | - | Creates link only |
Cross-product JIRA integration for embedding JIRA issues in Confluence pages, creating bidirectional links, and managing JIRA macros.
Embed JIRA issues in a page using JQL query or specific issue keys.
Usage:
# Embed issues matching a JQL query
confluence jira embed 12345 --jql "project = PROJ AND status = Open"
# Embed specific issues by key
confluence jira embed 12345 --issues PROJ-123,PROJ-456
# Replace page content with JIRA macro (instead of append)
confluence jira embed 12345 --jql "project = PROJ" --mode replace
# Customize columns and limit results
confluence jira embed 12345 --jql "assignee = currentUser()" --columns key,summary,status --max-results 50
# With specific JIRA server
confluence jira embed 12345 --jql "project = PROJ" --server-id abc123
# JSON output
confluence jira embed 12345 --issues PROJ-123 --output json
Options:
--jql: JQL query to filter issues (mutually exclusive with --issues)--issues: Comma-separated list of issue keys--mode: How to add the macro: append (default) or replace--server-id: JIRA server ID (optional)--columns: Columns to display (comma-separated)--max-results: Maximum number of issues (default: 20)--output: Output format (text or json)List JIRA issues linked to a page.
Usage:
confluence jira linked 12345
confluence jira linked 12345 --output json
Options:
--output: Output format (text or json)Create a JIRA issue from Confluence page content. Uses page title as summary and extracted text as description.
Usage:
# Basic usage (requires JIRA env vars: JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN)
confluence jira create-from-page 12345 --project PROJ --type Task
# With priority and assignee
confluence jira create-from-page 12345 --project PROJ --type Bug --priority High --assignee jsmith
# With explicit JIRA credentials
confluence jira create-from-page 12345 --project PROJ --type Story \
--jira-url https://jira.example.com \
--jira-email user@example.com \
--jira-token your-api-token
# JSON output
confluence jira create-from-page 12345 --project PROJ --type Task --output json
Options:
--project, -p: JIRA project key (required)--type, -t: Issue type (default: Task). Common values include: Task, Story, Bug, Epic, Subtask, Improvement, New Feature. Any valid issue type for your JIRA project is accepted.--priority: Priority level (e.g., High, Medium, Low)--assignee: Assignee username--jira-url: JIRA base URL (or set JIRA_URL env var)--jira-email: JIRA email (or set JIRA_EMAIL env var)--jira-token: JIRA API token (or set JIRA_API_TOKEN env var)--output: Output format (text or json)Create a remote link between a Confluence page and a JIRA issue. The link appears in both systems.
Implementation Note: Links are tracked using HTML comment markers in the page content (e.g., <!-- JIRA-LINK: PROJ-123 -->). The --skip-if-exists option checks for these markers to avoid duplicate links.
Usage:
# Basic link (jira-url is required)
confluence jira link 12345 PROJ-123 --jira-url https://jira.example.com
# With custom relationship type
confluence jira link 12345 PROJ-123 --jira-url https://jira.example.com --relationship documents
# Skip if link already exists
confluence jira link 12345 PROJ-123 --jira-url https://jira.example.com --skip-if-exists
# JSON output
confluence jira link 12345 PROJ-123 --jira-url https://jira.example.com --output json
Options:
--jira-url: Base JIRA URL (required, e.g., https://jira.example.com)--relationship: Relationship type (default: "relates to"). Common values include: relates to, documents, mentions, references, implements. Any string value is accepted. Note: This is descriptive metadata stored in the link; it does not affect how Confluence or JIRA process the link itself.--skip-if-exists: Skip if link already exists--output: Output format (text or json)Refresh or update JIRA macros on a page. Can force a page update to trigger macro refresh or update JQL queries in existing macros.
Usage:
# Force page update to refresh all JIRA macros
confluence jira sync-macro 12345
# Update JQL in all JIRA macros on the page
confluence jira sync-macro 12345 --update-jql "project = PROJ AND status = Open"
# Update JQL in a specific macro by index (0-based)
confluence jira sync-macro 12345 --update-jql "status = Done" --macro-index 0
# JSON output
confluence jira sync-macro 12345 --output json
Options:
--update-jql: New JQL query to set in macros--macro-index: Index of macro to update (0-based). If not specified, updates all macros--output: Output format (text or json)