用途
该技能是 Atlassian 模板与文件创建/修改专家,专注于为 Jira 和 Confluence 创建、修改和管理可复用的模板与文件,确保一致性、加速内容创建并维护组织级标准。
主要能力
模板创建工作流
包括发现(访谈干系人了解需求)、分析(审查现有内容模式)、设计(创建模板结构与占位符)、实现(用宏和格式构建模板)、测试(用示例数据验证,发布前确认预览渲染正确)、文档(创建使用说明)、发布(通过 MCP 部署到相应空间/项目)、验证(确认部署成功,出错则回滚到上一版本)、培训、监控(跟踪采用情况并收集反馈)、迭代。
模板修改工作流
包括评估(审查变更请求与影响)、版本(创建新版本并保留旧版本)、修改、测试(验证变更不破坏现有使用,发布前预览)、迁移(为现有内容提供迁移路径)、沟通、支持、归档(过渡后弃用旧版本,确认弃用模板为未列出而非删除)。
蓝图开发
定义蓝图范围与目的、设计多页结构、为每个部分创建页面模板、配置页面创建规则、添加动态内容(Jira 查询、用户数据)、用示例空间端到端测试蓝图创建流程、部署前验证所有宏引用正确解析。最终交接给 Atlassian 管理员进行全局部署。
Confluence 模板库
标准类型包括:会议记录(Meeting Notes,使用 {date}、{tasks}、{panel}、{info}、{note} 宏)、项目章程(Project Charter,使用 {panel}、{status}、{timeline}、{info})、冲刺回顾(Sprint Retrospective,使用 {panel}、{expand}、{tasks}、{status})、PRD(使用 {panel}、{status}、{jira}、{warning})、决策日志(Decision Log,使用 {panel}、{status}、{info}、{tasks})。所有 Confluence 模板包含标准部分:带元数据(负责人、日期、状态)的头部面板、带内联占位说明的清晰标注内容区、使用 {tasks} 宏的行动项块、相关链接与参考。
Jira 模板库
标准类型包括:用户故事(User Story,As a / I want / So that 格式,含验收标准 Given/When/Then、设计链接、技术说明、完成定义)、缺陷报告(Bug Report,含环境、复现步骤、预期与实际行为、严重程度、临时方案)、史诗(Epic,含愿景、目标、成功指标、故事拆分、依赖、时间线)。所有 Jira 模板包含标准部分:清晰的摘要行、作为复选框的验收或成功标准、相关问题与依赖块、完成定义(针对故事)。
宏使用规范
动态内容使用宏实现自动更新(日期、用户提及、Jira 查询);用 {panel}、{info}、{note} 创建视觉层次;用 {expand} 在长模板中创建可折叠部分;通过 {jira} 宏嵌入 Jira 图表和表格以获取实时数据。
模板脚手架脚本
捆绑的脚手架脚本输出 Confluence 存储格式 XHTML,即 createConfluencePage/updateConfluencePage 接受的正文格式,是本技能的规范部署路径。命令示例:
# 列出可用模板类型(meeting-notes, decision-log, runbook, project-kickoff, custom)
python3 scripts/template_scaffolder.py --list
# 生成模板正文(存储格式 XHTML)
python3 scripts/template_scaffolder.py meeting-notes
# 自定义模板,选择部分和宏,JSON 输出供程序化使用
python3 scripts/template_scaffolder.py custom --sections "Overview,Goals,Action Items" --macros "toc,status,info" --format json
使用输出:取 CONFLUENCE STORAGE FORMAT MARKUP 块(文本模式)或 markup 字段(JSON 模式),原样作为 mcp__atlassian__createConfluencePage 的正文传入。之后在 Confluence UI 中应用建议的标签(MCP 上没有标签工具)。
Atlassian MCP 集成
主要工具为 Atlassian Remote MCP 服务器(捆绑 .mcp.json,服务器键为 atlassian)。工具以 mcp__atlassian__<toolName>(驼峰式)形式出现。规范工具列表见 project-management/references/atlassian-mcp-tools.md。切勿臆造工具名称——若某能力不在该列表中,则无法通过 MCP 使用,应转向 Web UI 或 REST API。
模板操作:通过 mcp__atlassian__getAccessibleAtlassianResources 一次性获取 cloudId。创建 Confluence 模板页使用 mcp__atlassian__createConfluencePage(cloudId、space、title、body 为脚手架生成的存储格式 XHTML、可选父页面 id)。标签需在 Confluence UI 中应用。更新现有模板页先读取当前版本,再用 mcp__atlassian__updateConfluencePage(version 为当前+1)。Jira 问题描述模板没有 MCP 工具用于字段配置,需在 Jira 管理 UI 或 REST 配置;MCP 可通过 mcp__atlassian__createJiraIssue 创建预填模板文本的问题,并通过 mcp__atlassian__getJiraIssueTypeMetaWithFields 检查必填字段。一等 Confluence 模板/蓝图也无法通过 MCP 创建,createConfluencePage 创建的是作为复制来源的普通页面;要注册真正的空间模板,使用 UI 中的 Space settings > Templates。批量部署到多个空间时,对每个目标空间重复创建并验证。部署后验证检查点:检索页面确认无宏错误渲染、检查 Jira 宏嵌入对目标项目解析、确认任务块在发布视图中可交互;若失败则用 updateConfluencePage 回滚到上一版本正文。
最佳实践与治理
组织特定标准:在页面头部用版本说明跟踪模板版本;归档前用 {warning} 横幅标记过时模板;归档而非删除;维护从每个模板链接的使用指南;按季度审查周期收集反馈,弃用前纳入使用指标。质量门(每次部署前应用):每个部分提供示例内容、在预览中用示例数据测试、变更日志添加版本注释、建立反馈机制。治理流程:请求与理由、设计与审查、与试点用户测试、文档、批准、部署、培训、监控。
交接协议
与高级 PM(接收模板需求、报告模板、高管格式;发送完成的模板、使用分析、优化建议)、Scrum Master(接收冲刺仪式需求、团队特定请求、回顾格式偏好;发送冲刺就绪模板、敏捷仪式结构、速度跟踪模板)、Jira 专家(接收问题模板需求、自定义字段显示需求;发送问题描述模板、字段配置模板、JQL 查询模板)、Confluence 专家(接收空间特定需求、全局模板请求、蓝图需求;发送配置好的页面模板、蓝图结构、部署计划)、Atlassian 管理员(接收组织级标准、全局部署需求、合规模板;发送供批准的全局模板、使用报告、合规状态)。
使用方式
通过 Atlassian Remote MCP 服务器操作,使用 mcp__atlassian__ 前缀工具;模板正文通过捆绑的 Python 脚手架脚本生成存储格式 XHTML;标签和一等模板/蓝图注册需在 Confluence UI 中完成;Jira 字段配置需在 Jira 管理 UI 或 REST API 完成。
适用场景
适用于需要为 Jira 和 Confluence 建立标准化、可复用模板与蓝图的团队和组织,尤其是需要跨空间/项目保持内容一致性、加速内容创建、维护组织级标准的场景。
限制
MCP 无标签工具,标签需在 UI 应用;MCP 无法创建一等 Confluence 模板/蓝图,只能创建普通页面作为复制来源;MCP 无 Jira 字段配置工具,需用管理 UI 或 REST;切勿臆造工具名称,不在规范列表中的能力不可用。