mcpField
A
atlassian-templates

atlassian-templates

github.com/borghei生产力1.0k138 次安装6 天前更新
代码仓库

关于 atlassian-templates

atlassian-templates 是为 Jira 和 Confluence 创建、修改及管理模板的技能，适用于负责内容标准化的团队。它涵盖动态模板、蓝图、版本管理和生命周期治理。

主要功能

  1. 01Confluence 页面模板设计
  2. 02Jira 问题描述模板
  3. 03多页面蓝图
  4. 04动态字段与宏
  5. 05模板版本及生命周期管理
  6. 06采用情况跟踪

适用场景

  1. 01建立组织级 Confluence 模板
  2. 02为 Jira 问题统一描述格式
  3. 03将分散文档迁移到标准模板
  4. 04排查宏故障或模板版本混乱

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/borghei/claude-skills --skill atlassian-templates

安装后在 Claude Code 中输入/atlassian-templates确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

examples/
unified-prd-epic-story-rollout.md
references/
confluence-templates.md
jira-templates.md
red-flags.md
troubleshooting.md
workflows-and-governance.md
scripts/
template_scaffolder.py
template_usage_analyzer.py
template_validator.py

详细介绍

Atlassian 模板与文件创建专家

专注于为 Jira 和 Confluence 创建、修改和管理可复用的模板与文件。通过采用规范化、参数化的模板，而非为每种使用场景分别创建模板，确保内容一致、加快内容创建并维护全组织标准。

核心能力

  • 模板设计 — 包含动态内容的 Confluence 页面模板、Jira 问题模板／描述、多页面结构蓝图、版本管理
  • 内容标准化 — 全组织标准、可复用组件和宏、模板库、文档
  • 自动化 — 动态字段、Jira 集成、自更新结构、基于模板的工作流
  • 治理 — 生命周期管理、版本控制、弃用、使用情况／采用率跟踪

适用场景

  • 构建全组织通用的 Confluence 页面模板或 Jira 问题模板
  • 为复杂的多页面内容结构设计蓝图
  • 建立内容标准和精选模板库
  • 帮助团队从临时创建、从头编写的页面迁移到标准化模板
  • 诊断模板采用率低、宏失效或版本混乱等问题

请先确认

创建模板前，请确认以下信息。如果有任何一项未知或含糊不清，请先询问，不要自行假设：

  • 目标工具与产物 — Confluence 页面模板、Jira 问题模板，还是多页面蓝图（决定可用的宏／字段和结构）
  • 模板类型 — 会议记录、PRD、章程、错误报告、决策日志等（决定基础结构和占位符）
  • 推广范围 — 单个团队还是全组织通用的规范模板（影响参数化、命名和治理）
  • 动态还是静态内容 — 哪些字段通过宏／Jira 查询自动填充，哪些是固定占位符（影响构建复杂度和采用率）

停止规则：只询问最可能改变产出的 2-3 项。如果用户说“先起草就行”，请继续，并在产物顶部列出你的假设。

快速入门

  1. 了解利益相关方的需求，并审查现有内容模式
  2. 设计结构，加入清晰的占位符和行内说明
  3. 构建模板，使用宏（面板、信息／备注、任务、状态、动态 Jira 查询）
  4. 使用示例数据测试，然后发布到目标空间／项目
  5. 培训用户并监控采用情况；每季度迭代

从下方的模板库中选取现成的起点，然后按照 references/workflows-and-governance.md 中的完整创建／修改工作流操作。

参考资料

加载与任务匹配的参考资料——保持此文件精简，按需查阅详细内容：

  • references/confluence-templates.md — 完整的 Confluence 模板库（会议记录、项目章程、冲刺回顾、PRD、决策日志）。需要可直接粘贴的 Confluence 页面模板时阅读。
  • references/jira-templates.md — 完整的 Jira 问题模板库（用户故事、错误报告、史诗）。需要可直接粘贴的 Jira 描述时阅读。
  • references/workflows-and-governance.md — 创建／修改／蓝图工作流的分步说明、最佳实践、角色交接流程、治理和 Atlassian MCP 操作。构建、修改或投入使用模板时阅读。
  • references/troubleshooting.md — 故障排查表（采用率、宏失效、版本管理、数据过时）和可衡量的成功标准。已部署的模板出现异常或需要定义完成标准时阅读。
  • references/red-flags.md — 模板产出常见问题及错误／正确示例（包括模板泛滥等）。发布供全组织使用的模板前阅读。

范围与限制

范围内： Confluence 页面模板设计与部署、Jira 问题描述模板、蓝图开发、模板治理与生命周期管理、模板版本管理、使用情况分析跟踪、模板使用培训、通过宏增强的动态模板。

范围外： Atlassian 全局管理（转交给 atlassian-admin/）、Jira 工作流和自动化设计（转交给 jira-expert/）、Confluence 空间架构（转交给 confluence-expert/）、内容策略和文档标准（转交给 confluence-expert/）。

限制： Confluence Cloud 模板无法包含所有类型的宏（创建页面后，部分高级宏需要手动插入）。Jira 问题模板仅限于描述字段内容——如果没有自动化规则，就无法预设自定义字段值。模板分析需要 Confluence Premium 或 Marketplace 分析应用，才能获取详细的使用指标。

集成点

集成方向流转内容
confluence-expert/双向Confluence 专家定义内容标准；模板创建者将其实现为模板
jira-expert/模板 -> Jira问题描述模板、工作流文档模板
atlassian-admin/管理员 -> 模板全局模板部署审批、治理政策
scrum-master/SM -> 模板Sprint 仪式模板需求、回顾会议格式偏好
senior-pm/PM -> 模板高管报告模板、项目组合跟踪布局
delivery-manager/DM -> 模板事后复盘模板、发布清单模板、运行手册结构

评论

支持 Markdown