confluence-expert

Atlassian Confluence Expert

Master-level expertise in Confluence space management, documentation architecture, content creation, macros, templates, and collaborative knowledge management.

Atlassian MCP Integration

Primary 工具: Confluence MCP Server

Key Operations:

// 创建 a new space 创建_space({ key: "TEAM", name: "Engineering Team", description: "Engineering team knowledge base" })

// 创建 a page under a parent 创建_page({ spaceKey: "TEAM", title: "Sprint 42 Notes", parentId: "123456", body: "

Meeting notes in storage-格式化 HTML

// 更新 an existing page (version must be incremented) 更新_page({ pageId: "789012", version: 4, body: "

更新d content

// 删除 a page 删除_page({ pageId: "789012" })

// 搜索 with CQL 搜索({ cql: 'space = "TEAM" AND label = "meeting-notes" ORDER BY lastModified DESC' })

// Retrieve child pages for hierarchy inspection 获取_children({ pageId: "123456" })

// 应用ly a label to a page 添加_label({ pageId: "789012", label: "归档d" })

Integration Points:

创建 documentation for Senior PM projects Support Scrum Master with ceremony templates Link to Jira issues for Jira Expert Provide templates for Template 创建器

See also: MACROS.md for macro syntax reference, TEMPLATES.md for full template 库, 权限S.md for 权限 scheme detAIls.

工作流s Space Creation Determine space type (Team, Project, Knowledge Base, Personal) 创建 space with clear name and description 设置 space homepage with overview 配置 space 权限s: View, Edit, 创建, 删除 Admin privileges 创建 initial page tree structure 添加 space shortcuts for navigation 验证: Navigate to the space URL and confirm the homepage loads; 检查 that a non-admin test user sees the correct 权限 level HANDOFF TO: Teams for content population Page Architecture

Best Practices:

Use page hierarchy (parent-child relationships) Maximum 3 levels deep for navigation Consistent naming conventions Date-stamp meeting notes

Recommended Structure:

Space Home ├── Overview & 获取ting 启动ed ├── Team In格式化ion │ ├── Team Members & 角色s │ ├── Communication Channels │ └── Working Agreements ├── Projects │ ├── Project A │ │ ├── Overview │ │ ├── Requirements │ │ └── Meeting Notes │ └── Project B ├── Processes & 工作流s ├── Meeting Notes (归档) └── Resources & References

Template Creation Identify repeatable content pattern 创建 page with structure and placeholders 添加 instructions in placeholders 格式化 with 应用ropriate macros Save as template 分享 with space or make global 验证: 创建 a test page from the template and confirm all placeholders render correctly before sharing with the team USE: References for advanced template patterns Documentation Strategy Assess current documentation 状态 Define documentation goals and audience Organize content taxonomy and structure 创建 templates and 图形界面delines 迁移 existing documentation TrAIn teams on best practices 监控 usage and adoption 报告 TO: Senior PM on documentation 健康 Knowledge Base Management

Article Types:

How-to 图形界面des Troubleshooting docs FAQs Reference documentation Process documentation

质量 Standards:

Clear title and description Structured with headings 更新d date visible Owner identified Reviewed quarterly Essential Macros

Full macro reference with all parameters: see MACROS.md.

Content Macros

信息, Note, 警告, Tip:

{信息} 导入ant in格式化ion here {信息}

Expand:

{expand:title=命令行工具ck to expand} Hidden content here {expand}

Table of Contents:

{toc:maxLevel=3}

Excerpt & Excerpt Include:

{excerpt} Reusable content {excerpt}

{excerpt-include:Page Name}

Dynamic Content

Jira Issues:

{jira:JQL=project = PROJ AND 状态 = "In 进度"}

Jira 图表:

{jira图表:type=pie|jql=project = PROJ|statType=状态es}

Recently 更新d:

{recently-更新d:spaces=@all|max=10}

Content by Label:

{contentbylabel:label=meeting-notes|max结果s=20}

Collaboration Macros

状态:

{状态:colour=Green|title=应用roved}

Task 列出:

{tasks}

• [ ] Task 1
• [x] Task 2 completed

User Mention:

@username

Date:

{date:格式化=dd MMM yyyy}

Page Layouts & 格式化ting

Two-Column Layout:

{section} {column:width=50%} Left content {column} {column:width=50%} Right content {column} {section}

Panel:

{panel:title=Panel Title|borderColor=#ccc} Panel content {panel}

Code Block:

{code:javascript} const example = "code here"; {code}

Templates 库

Full template 库 with complete markup: see TEMPLATES.md. Key templates summarised below.

Template Purpose Key Sections Meeting Notes Sprint/team meetings Agenda, Discussion, Decisions, Action Items (tasks macro) Project Overview Project kickoff & 状态 Quick Facts panel, Objectives, Stakeholders table, Milestones (Jira macro), Risks Decision 记录 Architectural/strategic decisions 上下文, Options Considered, Decision, Consequences, Next Steps Sprint Retrospective Agile ceremony docs What Went Well