childbamboo Jira to Markdown Conversion Skill
Atlassian MCPを使用してJiraデータを取得し、AI可読性の高いMarkdown形式に変換します。
対応タスク
- Jira issueの詳細情報をMarkdownドキュメントに変換
- Jiraバックログ（未解決issue一覧）をMarkdownテーブルに変換
- Sprintの内容をMarkdown形式でドキュメント化
- 複数のissueを構造化されたMarkdownレポートに変換
環境情報
Cloud ID
- hadron.atlassian.net:
f6e0f50a-4acf-4011-90fa-8fcc9b50cd86
利用可能なMCPツール
mcp__atlassian__getJiraIssue- 個別Issue詳細取得mcp__atlassian__searchJiraIssuesUsingJql- JQL検索mcp__atlassian__getVisibleJiraProjects- プロジェクト一覧取得
Markdown変換パターン
1. Issue詳細のMarkdown化
# [ISSUE-KEY] タイトル
## メタデータ
- **ステータス**: {status}
- **タイプ**: {issueType}
- **担当者**: {assignee or [未割り当て]}
- **優先度**: {priority or [未設定]}
- **作成日**: {created}
- **更新日**: {updated}
## 説明
{description or [未記入]}
## コメント
{comments}
## 添付ファイル
{attachments}
2. バックログのテーブル化
## バックログ一覧
| キー | タイプ | サマリー | ステータス | 担当者 | 優先度 | 作成日 |
|------|--------|----------|------------|--------|--------|---------|
| SCRUM-1 | Feature | タスク 1 | Idea | [未割り当て] | [未設定] | 2026-01-06 |
| SCRUM-2 | タスク | タスク 2 | To Do | [未割り当て] | [未設定] | 2026-01-06 |
3. Sprint情報のMarkdown化
## Sprint情報
- **名前**: SCRUM Sprint 0
- **状態**: active
- **開始日**: 2026-01-06
- **終了日**: 2026-01-20
### Sprint内のIssue
| キー | サマリー | ステータス | 担当者 |
|------|----------|------------|--------|
| ... | ... | ... | ... |
データ取得ワークフロー
バックログ取得
mcp__atlassian__searchJiraIssuesUsingJqlを使用- JQL:
project = {PROJECT_KEY} AND resolution = Unresolved ORDER BY created DESC - 取得フィールド: summary, status, issuetype, priority, created, assignee
個別Issue取得
mcp__atlassian__getJiraIssueを使用- issueIdOrKey:
{ISSUE_KEY} - すべてのフィールドを取得
構造化ルール
- メタデータを先頭に配置 - 重要な情報を最初に表示
- 未記入項目の明示 -
[未記入]、[未割り当て]、[未設定]と明記 - 日付の整形 - ISO形式から読みやすい形式に変換（YYYY-MM-DD）
- プレースホルダーと実データの区別 - 実データと説明文を明確に分離
- 階層構造の維持 - 見出しレベルで情報の重要度を表現
- テーブルの活用 - 一覧データは必ずテーブル形式で表現
変換時の注意事項
- null値は
[未設定]または[未記入]と表示 - 日本語と英語のフィールド名が混在する場合は、日本語を優先
- SprintフィールドはcustomField_10020として取得される
- Issue keyは必ずリンクまたは強調表示
使用例
例1: プロジェクトのバックログ取得
「SCRUMプロジェクトのバックログをMarkdownで出力して」
→ JQL検索 + Markdown変換
例2: 個別Issue詳細
「SCRUM-5の詳細をMarkdownで」
→ Issue取得 + Markdown変換
例3: Sprint内容の可視化
「Sprint 0の内容をまとめて」
→ Sprint検索 + Issue一覧取得 + Markdown変換
参考資料
- Atlassian MCP Server Documentation
- Jira REST API Reference
- JQL (Jira Query Language) Syntax