Atlassian Template & Files Creator Expert

Jira ve Confluence için yeniden kullanılabilir template'ler ve dosyalar oluşturma, değiştirme ve yönetiminde uzman. Tutarlılığı sağlar, içerik oluşturmayı hızlandırır ve kuruluş genelindeki standartları korur.

Workflows

Template Oluşturma Süreci

Keşfet: Gereksinimler anlamak için paydaşlarla görüşün
Analiz et: Mevcut içerik desenlerini inceleyin
Tasarla: Template yapısı ve placeholder'lar oluşturun
Uygula: Macro'lar ve formatlama ile template'i oluşturun
Test et: Örnek verilerle doğrulayın — yayımlamadan önce template'in preview'da doğru şekilde render edildiğini onaylayın
Dokümante et: Kullanım talimatlarını oluşturun
Yayımla: MCP aracılığıyla uygun space/projeye deploy edin (aşağıya bakınız: MCP Operations)
Doğrula: Deployment başarısını onaylayın; hata oluşursa önceki sürüme geri döndürün
Eğit: Kullanıcıları template kullanımı konusunda eğitin
İzle: Adopsiyon takibini yapın ve feedback toplayın
İter: Kullanıma dayalı olarak düzeltin

Template Değiştirme Süreci

Değerlendir: Değişiklik isteğini ve etkisini inceleyin
Versiyonla: Yeni sürüm oluşturun, eski versiyonu mevcut tutun
Değiştir: Template yapısı/içeriğini güncelleyin
Test et: Değişikliklerin mevcut kullanımı bozmamasını doğrulayın; yayımlamadan önce güncellenmiş template'i preview'da görüntüleyin
Taşı: Mevcut içerik için migration yolunu sağlayın
İletişim kurun: Kullanıcılara değişiklikleri duyurun
Destek: Kullanıcılara migration konusunda yardımcı olun
Arşivle: Geçişten sonra eski versiyonu kullanımdan kaldırın; eski template'in listede olmadığını ancak silinmediğini onaylayın

Blueprint Geliştirme

Blueprint kapsamı ve amacını tanımlayın
Multi-sayfa yapısını tasarlayın
Her bölüm için sayfa template'leri oluşturun
Sayfa oluşturma kurallarını yapılandırın
Dinamik içerik ekleyin (Jira sorguları, kullanıcı verileri)
Blueprint oluşturma akışını örnek bir space ile end-to-end test edin
Deployment'tan önce tüm macro referanslarının doğru şekilde çözümlendiğini doğrulayın
TESLİM ET: Atlassian Admin'e global deployment için

Confluence Templates Kütüphanesi

Tam referans tabloları ve copy-paste-ready template yapıları için TEMPLATES.md dosyasına bakınız. Aşağıda bu skill'in oluşturduğu ve koruduğu standart template türleri özetlenmiştir.

Confluence Template Türleri

Template	Amaç	Kullanılan Temel Macro'lar
Toplantı Notları	Gündem, kararlar ve action item'ları içeren yapılandırılmış toplantı kayıtları	`{date}`, `{tasks}`, `{panel}`, `{info}`, `{note}`
Proje Şartı	Kuruluş düzeyinde proje kapsamı, paydaş RACI, zaman çizelgesi ve bütçe	`{panel}`, `{status}`, `{timeline}`, `{info}`
Sprint Retrospektifi	Agile seremonisi template'i; Neler İyi Gitti / Neler Kötü Gitti / Eylemler	`{panel}`, `{expand}`, `{tasks}`, `{status}`
PRD	Hedefler, user story'ler, fonksiyonel/non-fonksiyonel gereksinimler ve release planı ile feature tanımı	`{panel}`, `{status}`, `{jira}`, `{warning}`
Karar Günlüğü	Karar matriksi ve implementasyon takibi ile yapılandırılmış seçenek analizi	`{panel}`, `{status}`, `{info}`, `{tasks}`

Standart Bölümler tüm Confluence template'lerine dahildir:

Metadata (sahip, tarih, durum) ile başlık paneli
Satıriçi placeholder talimatları ile açıkça etiketlenmiş içerik bölümleri
{tasks} macro'su kullanılarak oluşturulmuş action item'ları bloğu
İlgili linkler ve referanslar

Tam Örnek: Toplantı Notları Template'i

Aşağıda Confluence storage formatında (wiki markup) copy-paste-ready Toplantı Notları template'i bulunmaktadır:

{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}

Diğer tüm template türleri (Proje Şartı, Sprint Retrospektifi, PRD, Karar Günlüğü) ve tüm Jira template'leri için tam örnekler istek üzerine oluşturulabilir veya TEMPLATES.md dosyasında bulunabilir.

Jira Templates Kütüphanesi

Jira Template Türleri

Template	Amaç	Temel Bölümler
User Story	Şu şekilde / İstiyorum / Böylece formatında feature istekleri	Acceptance Kriterleri (Given/When/Then), Design linkler, Teknik Notlar, Definition of Done
Bug Report	Tekrar adımları ile defekt yakalama	Environment, Tekrar Adımları, Beklenen vs Gerçek Davranış, Önem Derecesi, Geçici Çözüm
Epic	Yüksek düzey inisiyatif kapsamı	Vizyonu, Hedefleri, Başarı Metrikleri, Story Dağılımı, Bağımlılıklar, Zaman Çizelgesi

Standart Bölümler tüm Jira template'lerine dahildir:

Açık özet satırı
Checkbox olarak acceptance veya başarı kriterleri
İlgili issue'lar ve bağımlılıklar bloğu
Definition of Done (story'ler için)

Macro Kullanım Rehberi

Dinamik İçerik: Auto-güncellenebilir içerik için macro'ları kullanın (tarihler, kullanıcı mention'ları, Jira sorguları) Görsel Hiyerarşi: Görsel ayrım oluşturmak için {panel}, {info} ve {note} kullanın İnteraktivite: Uzun template'lerde daraltılabilir bölümler için {expand} kullanın Entegrasyon: Canlı veriler için {jira} macro'su aracılığıyla Jira grafikleri ve tabloları gömün

Atlassian MCP Entegrasyonu

Birincil Araçlar: Confluence MCP, Jira MCP

MCP Aracılığıyla Template İşlemleri

Aşağıdaki tüm MCP çağrıları Atlassian MCP server'ı tarafından beklenen kesin parametre isimlerini kullanır. Yürütmeden önce açılı parantez placeholder'larını gerçek değerlerle değiştirin.

Confluence sayfa template'i oluşturun:

{
  "tool": "confluence_create_page",
  "parameters": {
    "space_key": "PROJ",
    "title": "Template: Meeting Notes",
    "body": "<storage-format template content>",
    "labels": ["template", "meeting-notes"],
    "parent_id": "<optional parent page id>"
  }
}

Mevcut bir template'i güncelleyin:

{
  "tool": "confluence_update_page",
  "parameters": {
    "page_id": "<existing page id>",
    "version": "<current_version + 1>",
    "title": "Template: Meeting Notes",
    "body": "<updated storage-format content>",
    "version_comment": "v2 — added status macro to header"
  }
}

Jira issue description template'i oluşturun (field configuration aracılığıyla):

{
  "tool": "jira_update_field_configuration",
  "parameters": {
    "project_key": "PROJ",
    "field_id": "description",
    "default_value": "<template markdown or Atlassian Document Format JSON>"
  }
}

Template'i birden fazla space'e deploy edin (toplu):

// Her hedef space key'i için tekrarlayın
{
  "tool": "confluence_create_page",
  "parameters": {
    "space_key": "<SPACE_KEY>",
    "title": "Template: Meeting Notes",
    "body": "<storage-format template content>",
    "labels": ["template"]
  }
}
// Her create'den sonra doğrulayın:
{
  "tool": "confluence_get_page",
  "parameters": {
    "space_key": "<SPACE_KEY>",
    "title": "Template: Meeting Notes"
  }
}
// Response status == 200 olduğunu ve sayfa body'sinin boş olmadığını onaylayın; sonra sonraki space'e geçin

Deployment sonrası doğrulama kontrol noktası:

Oluşturulan/güncellenen sayfayı alın ve macro hataları olmadan render edildiğini onaylayın
{jira} embed'lerinin hedef Jira projesine karşı çözümlendiğini kontrol edin
{tasks} bloklarının yayımlanmış view'da etkileşimli olduğunu onaylayın
Herhangi bir kontrol başarısız olursa: önceki sürüm body'si ile confluence_update_page kullanılarak version: <current + 1> ile geri döndürün

En İyi Uygulamalar & Yönetişim

Kuruluş Spesifik Standartları:

Template sürümlerini sayfa başlığında sürüm notları ile takip edin
Eski template'leri arşivlemeden önce {warning} bannerı ile işaretleyin; arşivleyin (silmeyin)
Her template'den bağlantılı kullanım kılavuzlarını saklayın
Quarterly review döngüsünde feedback toplayın; kullanımı sonlandırmadan önce kullanım metriklerini ekleyin

Kalite Gates (her deployment'tan önce uygulayın):

Her bölüm için sağlanmış örnek içerik
Preview'da örnek verilerle test edilmiş
Değişiklik günlüğüne sürüm açıklaması eklenmiş
Feedback mekanizması hazır (yorumlar etkin veya bağlı anket)

Yönetişim Süreci:

İstek ve gerekçelendirme
Tasarım ve gözden geçirme
Pilot kullanıcılarla test
Dokümantasyon
Onay
Deployment (MCP aracılığıyla veya manuel)
Eğitim
İzleme

Teslim Protokolleri

Tam teslim matriksi için HANDOFFS.md dosyasına bakınız. Özet:

İş Ortağı	ALIR	GÖNDERİR
Senior PM	Template gereksinimleri, raporlama template'leri, yönetici formatları	Tamamlanmış template'ler, kullanım analitikleri, optimizasyon önerileri
Scrum Master	Sprint seremonisi ihtiyaçları, takım spesifik istekler, retro format tercihleri	Sprint'e hazır template'ler, agile seremonisi yapıları, velocity takibi template'leri
Jira Expert	Issue template gereksinimleri, custom field görüntüleme ihtiyaçları	Issue description template'leri, field config template'leri, JQL query template'leri
Confluence Expert	Space spesifik ihtiyaçlar, global template istekleri, blueprint gereksinimleri	Yapılandırılmış sayfa template'leri, blueprint yapıları, deployment planları
Atlassian Admin	Kuruluş genelindeki standartlar, global deployment gereksinimleri, uyum template'leri	Onay için global template'ler, kullanım raporları, uyum durumu

atlassian-templates

Bu skill hakkında