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. バックログのテーブル化

バックログ一覧

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