Atlassian Templates: 自动化 Jira & Confluence - Openclaw Skills
作者:互联网
2026-04-19
什么是 Atlassian Template & Files Creator?
Atlassian Template & Files Creator 旨在简化组织处理文档和问题跟踪的方式。通过利用 Openclaw Skills,这个由智能体主导的工具管理模板的整个生命周期——从利益相关者发现到技术实施和全球部署。它弥补了手动内容创建与自动化的、宏驱动的文档之间的差距,确保项目章程、PRD 和会议记录在所有部门中保持一致。
对于希望在不增加行政开销的情况下强制执行高质量文档标准的团队来说,这项技能特别有价值。无论您是在构建自定义蓝图还是在 Jira 中更新字段配置,Openclaw Skills 都能提供必要的 MCP 集成,以大规模且精确地执行这些任务。
下载入口:https://github.com/openclaw/skills/tree/main/skills/alirezarezvani/atlassian-templates
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install atlassian-templates
2. 手动安装
将技能文件夹复制到以下位置之一
全局模式~/.openclaw/skills/
工作区
/skills/
优先级:工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 atlassian-templates。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。
Atlassian Template & Files Creator 应用场景
- 为新计划自动创建标准化的项目章程和 PRD。
- 在多个敏捷团队中扩展 Sprint 回顾格式,以确保一致的数据收集。
- 标准化用户故事和错误报告的 Jira 问题描述模板,以提高开发人员的清晰度。
- 使用 Openclaw Skills 通过批量模板部署实施组织范围的文档标准。
- 分析利益相关者需求,以定义特定模板类型所需的结构、占位符和宏。
- 使用 Confluence 存储格式 (Wiki Markup) 或 Jira 兼容的 Markdown/ADF 生成模板内容。
- 执行 MCP 操作以在目标空间中创建或更新页面,并应用相关的标签和父级 ID。
- 进行验证检查,以确保 {jira}、{tasks} 和 {status} 等宏在实时环境中正确渲染。
- 通过更新现有模板并带有适当警告地存档过时版本来管理版本控制生命周期。
Atlassian Template & Files Creator 配置指南
要在您的环境中部署此技能,请确保您的 AI 智能体配置了 Atlassian MCP 服务器。在使用 Openclaw Skills 时,请使用以下环境变量对您的 Atlassian 实例进行身份验证。
# Set your Atlassian credentials
export CONFLUENCE_URL="https://your-domain.atlassian.net"
export JIRA_URL="https://your-domain.atlassian.net"
export ATLASSIAN_API_TOKEN="your-api-token-here"
配置完成后,智能体可以调用 confluence_create_page 或 jira_update_field_configuration 等工具来管理您的模板。
Atlassian Template & Files Creator 数据架构与分类体系
该技能使用特定的存储格式和元数据分类来管理内容,以确保与 Atlassian API 的兼容性。
| Data Type | Format | Key Metadata |
|---|---|---|
| Confluence Templates | XHTML Storage Format | space_key, labels, parent_id, version_comment |
| Jira Description Templates | Markdown / ADF JSON | project_key, field_id, default_value |
| Blueprint Definitions | Multi-page JSON | creation_rules, dynamic_query_params |
| Version History | MCP Version Logs | version_number, changelog_notes |
name: "atlassian-templates"
description: Atlassian Template and Files Creator/Modifier expert for creating, modifying, and managing Jira and Confluence templates, blueprints, custom layouts, reusable components, and standardized content structures. Use when building org-wide templates, custom blueprints, page layouts, and automated content generation.
Atlassian Template & Files Creator Expert
Specialist in creating, modifying, and managing reusable templates and files for Jira and Confluence. Ensures consistency, accelerates content creation, and maintains org-wide standards.
Workflows
Template Creation Process
- Discover: Interview stakeholders to understand needs
- Analyze: Review existing content patterns
- Design: Create template structure and placeholders
- Implement: Build template with macros and formatting
- Test: Validate with sample data — confirm template renders correctly in preview before publishing
- Document: Create usage instructions
- Publish: Deploy to appropriate space/project via MCP (see MCP Operations below)
- Verify: Confirm deployment success; roll back to previous version if errors occur
- Train: Educate users on template usage
- Monitor: Track adoption and gather feedback
- Iterate: Refine based on usage
Template Modification Process
- Assess: Review change request and impact
- Version: Create new version, keep old available
- Modify: Update template structure/content
- Test: Validate changes don't break existing usage; preview updated template before publishing
- Migrate: Provide migration path for existing content
- Communicate: Announce changes to users
- Support: Assist users with migration
- Archive: Deprecate old version after transition; confirm deprecated template is unlisted, not deleted
Blueprint Development
- Define blueprint scope and purpose
- Design multi-page structure
- Create page templates for each section
- Configure page creation rules
- Add dynamic content (Jira queries, user data)
- Test blueprint creation flow end-to-end with a sample space
- Verify all macro references resolve correctly before deployment
- HANDOFF TO: Atlassian Admin for global deployment
Confluence Templates Library
See TEMPLATES.md for full reference tables and copy-paste-ready template structures. The following summarises the standard types this skill creates and maintains.
Confluence Template Types
| Template | Purpose | Key Macros Used |
|---|---|---|
| Meeting Notes | Structured meeting records with agenda, decisions, and action items | {date}, {tasks}, {panel}, {info}, {note} |
| Project Charter | Org-level project scope, stakeholder RACI, timeline, and budget | {panel}, {status}, {timeline}, {info} |
| Sprint Retrospective | Agile ceremony template with What Went Well / Didn't Go Well / Actions | {panel}, {expand}, {tasks}, {status} |
| PRD | Feature definition with goals, user stories, functional/non-functional requirements, and release plan | {panel}, {status}, {jira}, {warning} |
| Decision Log | Structured option analysis with decision matrix and implementation tracking | {panel}, {status}, {info}, {tasks} |
Standard Sections included across all Confluence templates:
- Header panel with metadata (owner, date, status)
- Clearly labelled content sections with inline placeholder instructions
- Action items block using
{tasks}macro - Related links and references
Complete Example: Meeting Notes Template
The following is a copy-paste-ready Meeting Notes template in Confluence storage format (wiki markup):
{panel:title=Meeting Metadata|borderColor=#0052CC|titleBGColor=#0052CC|titleColor=#FFFFFF}
*Date:* {date}
*Owner / Facilitator:* @[facilitator name]
*Attendees:* @[name], @[name]
*Status:* {status:colour=Yellow|title=In Progress}
{panel}
h2. Agenda
# [Agenda item 1]
# [Agenda item 2]
# [Agenda item 3]
h2. Discussion & Decisions
{panel:title=Key Decisions|borderColor=#36B37E|titleBGColor=#36B37E|titleColor=#FFFFFF}
* *Decision 1:* [What was decided and why]
* *Decision 2:* [What was decided and why]
{panel}
{info:title=Notes}
[Detailed discussion notes, context, or background here]
{info}
h2. Action Items
{tasks}
* [ ] [Action item] — Owner: @[name] — Due: {date}
* [ ] [Action item] — Owner: @[name] — Due: {date}
{tasks}
h2. Next Steps & Related Links
* Next meeting: {date}
* Related pages: [link]
* Related Jira issues: {jira:key=PROJ-123}
Full examples for all other template types (Project Charter, Sprint Retrospective, PRD, Decision Log) and all Jira templates can be generated on request or found in TEMPLATES.md.
Jira Templates Library
Jira Template Types
| Template | Purpose | Key Sections |
|---|---|---|
| User Story | Feature requests in As a / I want / So that format | Acceptance Criteria (Given/When/Then), Design links, Technical Notes, Definition of Done |
| Bug Report | Defect capture with reproduction steps | Environment, Steps to Reproduce, Expected vs Actual Behavior, Severity, Workaround |
| Epic | High-level initiative scope | Vision, Goals, Success Metrics, Story Breakdown, Dependencies, Timeline |
Standard Sections included across all Jira templates:
- Clear summary line
- Acceptance or success criteria as checkboxes
- Related issues and dependencies block
- Definition of Done (for stories)
Macro Usage Guidelines
Dynamic Content: Use macros for auto-updating content (dates, user mentions, Jira queries) Visual Hierarchy: Use {panel}, {info}, and {note} to create visual distinction Interactivity: Use {expand} for collapsible sections in long templates Integration: Embed Jira charts and tables via {jira} macro for live data
Atlassian MCP Integration
Primary Tools: Confluence MCP, Jira MCP
Template Operations via MCP
All MCP calls below use the exact parameter names expected by the Atlassian MCP server. Replace angle-bracket placeholders with real values before executing.
Create a Confluence page template:
{
"tool": "confluence_create_page",
"parameters": {
"space_key": "PROJ",
"title": "Template: Meeting Notes",
"body": "",
"labels": ["template", "meeting-notes"],
"parent_id": ""
}
}
Update an existing template:
{
"tool": "confluence_update_page",
"parameters": {
"page_id": "",
"version": "",
"title": "Template: Meeting Notes",
"body": "",
"version_comment": "v2 — added status macro to header"
}
}
Create a Jira issue description template (via field configuration):
{
"tool": "jira_update_field_configuration",
"parameters": {
"project_key": "PROJ",
"field_id": "description",
"default_value": ""
}
}
Deploy template to multiple spaces (batch):
// Repeat for each target space key
{
"tool": "confluence_create_page",
"parameters": {
"space_key": "",
"title": "Template: Meeting Notes",
"body": "",
"labels": ["template"]
}
}
// After each create, verify:
{
"tool": "confluence_get_page",
"parameters": {
"space_key": "",
"title": "Template: Meeting Notes"
}
}
// Assert response status == 200 and page body is non-empty before proceeding to next space
Validation checkpoint after deployment:
- Retrieve the created/updated page and assert it renders without macro errors
- Check that
{jira}embeds resolve against the target Jira project - Confirm
{tasks}blocks are interactive in the published view - If any check fails: revert using
confluence_update_pagewithversion:and the previous version body
Best Practices & Governance
Org-Specific Standards:
- Track template versions with version notes in the page header
- Mark outdated templates with a
{warning}banner before archiving; archive (do not delete) - Maintain usage guides linked from each template
- Gather feedback on a quarterly review cycle; incorporate usage metrics before deprecating
Quality Gates (apply before every deployment):
- Example content provided for each section
- Tested with sample data in preview
- Version comment added to change log
- Feedback mechanism in place (comments enabled or linked survey)
Governance Process:
- Request and justification
- Design and review
- Testing with pilot users
- Documentation
- Approval
- Deployment (via MCP or manual)
- Training
- Monitoring
Handoff Protocols
See HANDOFFS.md for the full handoff matrix. Summary:
| Partner | Receives FROM | Sends TO |
|---|---|---|
| Senior PM | Template requirements, reporting templates, executive formats | Completed templates, usage analytics, optimization suggestions |
| Scrum Master | Sprint ceremony needs, team-specific requests, retro format preferences | Sprint-ready templates, agile ceremony structures, velocity tracking templates |
| Jira Expert | Issue template requirements, custom field display needs | Issue description templates, field config templates, JQL query templates |
| Confluence Expert | Space-specific needs, global template requests, blueprint requirements | Configured page templates, blueprint structures, deployment plans |
| Atlassian Admin | Org-wide standards, global deployment requirements, compliance templates | Global templates for approval, usage reports, compliance status |
相关推荐
专题
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
最新数据
相关文章
中国照明采购:LED 与智能照明情报 - Openclaw Skills
Agent Matchmaking: 自主发现与信任匹配 - Openclaw Skills
TweetNugget:精选技术与哲学语录 - Openclaw Skills
河南油田 PPT 生成器:专业演示文稿自动化 - Openclaw Skills
BS Detector:从长消息中提取核心真相 - Openclaw Skills
腾讯云智能顾问:云架构管理 - Openclaw Skills
落地页构建器:自动化 HTML 与转化优化 - Openclaw Skills
ToolDeck:个人 AI 工具与服务数据库 - Openclaw Skills
Sequence Alignment: NCBI BLAST API Integration - Openclaw Skills
Cap Table Manager:股权与稀释建模 - Openclaw Skills
AI精选
