Back to Details

jira-markdown-conversion

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Jira to Markdown Conversion Skill

Jira转Markdown转换技能

Atlassian MCPを使用してJiraデータを取得し、AI可読性の高いMarkdown形式に変換します。
使用Atlassian MCP获取Jira数据，并将其转换为AI易读的Markdown格式。

対応タスク

支持的任务

  • Jira issueの詳細情報をMarkdownドキュメントに変換
  • Jiraバックログ（未解決issue一覧）をMarkdownテーブルに変換
  • Sprintの内容をMarkdown形式でドキュメント化
  • 複数のissueを構造化されたMarkdownレポートに変換
  • 将Jira issue的详细信息转换为Markdown文档
  • 将Jira待办事项（未解决问题列表）转换为Markdown表格
  • 将Sprint内容以Markdown格式文档化
  • 将多个问题转换为结构化Markdown报告

環境情報

环境信息

Cloud ID

Cloud ID

  • hadron.atlassian.net: 
    f6e0f50a-4acf-4011-90fa-8fcc9b50cd86
  • hadron.atlassian.net: 
    f6e0f50a-4acf-4011-90fa-8fcc9b50cd86

利用可能なMCPツール

可用的MCP工具

  • mcp__atlassian__getJiraIssue
    - 個別Issue詳細取得
  • mcp__atlassian__searchJiraIssuesUsingJql
    - JQL検索
  • mcp__atlassian__getVisibleJiraProjects
    - プロジェクト一覧取得
  • mcp__atlassian__getJiraIssue
    - 获取单个Issue详情
  • mcp__atlassian__searchJiraIssuesUsingJql
    - JQL搜索
  • mcp__atlassian__getVisibleJiraProjects
    - 获取项目列表

Markdown変換パターン

Markdown转换模式

1. Issue詳細のMarkdown化

1. Issue详情转Markdown

markdown
undefined
markdown
undefined

[ISSUE-KEY] タイトル

[ISSUE-KEY] 标题

メタデータ

元数据

  • ステータス: {status}
  • タイプ: {issueType}
  • 担当者: {assignee or [未割り当て]}
  • 優先度: {priority or [未設定]}
  • 作成日: {created}
  • 更新日: {updated}
  • 状态: {status}
  • 类型: {issueType}
  • 负责人: {assignee or [未分配]}
  • 优先级: {priority or [未设置]}
  • 创建日期: {created}
  • 更新日期: {updated}

説明

描述

{description or [未記入]}
{description or [未填写]}

コメント

评论

{comments}
{comments}

添付ファイル

附件

{attachments}
undefined
{attachments}
undefined

2. バックログのテーブル化

2. 待办事项转表格

markdown
undefined
markdown
undefined

バックログ一覧

待办事项列表

キータイプサマリーステータス担当者優先度作成日
SCRUM-1Featureタスク 1Idea[未割り当て][未設定]2026-01-06
SCRUM-2タスクタスク 2To Do[未割り当て][未設定]2026-01-06
undefined
键类型摘要状态负责人优先级创建日期
SCRUM-1Feature任务1Idea[未分配][未设置]2026-01-06
SCRUM-2任务任务2To Do[未分配][未设置]2026-01-06
undefined

3. Sprint情報のMarkdown化

3. Sprint信息转Markdown

markdown
undefined
markdown
undefined

Sprint情報

Sprint信息

  • 名前: SCRUM Sprint 0
  • 状態: active
  • 開始日: 2026-01-06
  • 終了日: 2026-01-20
  • 名称: SCRUM Sprint 0
  • 状态: active
  • 开始日期: 2026-01-06
  • 结束日期: 2026-01-20

Sprint内のIssue

Sprint内的Issue

キーサマリーステータス担当者
............
undefined
键摘要状态负责人
............
undefined

データ取得ワークフロー

数据获取工作流

バックログ取得

待办事项获取

  1. mcp__atlassian__searchJiraIssuesUsingJql
    を使用
  2. JQL: 
    project = {PROJECT_KEY} AND resolution = Unresolved ORDER BY created DESC
  3. 取得フィールド: summary, status, issuetype, priority, created, assignee
  1. 使用
    mcp__atlassian__searchJiraIssuesUsingJql
  2. JQL: 
    project = {PROJECT_KEY} AND resolution = Unresolved ORDER BY created DESC
  3. 获取字段: summary, status, issuetype, priority, created, assignee

個別Issue取得

单个Issue获取

  1. mcp__atlassian__getJiraIssue
    を使用
  2. issueIdOrKey: 
    {ISSUE_KEY}
  3. すべてのフィールドを取得
  1. 使用
    mcp__atlassian__getJiraIssue
  2. issueIdOrKey: 
    {ISSUE_KEY}
  3. 获取所有字段

構造化ルール

结构化规则

  1. メタデータを先頭に配置 - 重要な情報を最初に表示
  2. 未記入項目の明示 - 
    [未記入]
    、
    [未割り当て]
    、
    [未設定]
    と明記
  3. 日付の整形 - ISO形式から読みやすい形式に変換（YYYY-MM-DD）
  4. プレースホルダーと実データの区別 - 実データと説明文を明確に分離
  5. 階層構造の維持 - 見出しレベルで情報の重要度を表現
  6. テーブルの活用 - 一覧データは必ずテーブル形式で表現
  1. 元数据置于顶部 - 重要信息优先展示
  2. 明确标注未填写项 - 用
    [未填写]
    、
    [未分配]
    、
    [未设置]
    标注
  3. 日期格式化 - 从ISO格式转换为易读格式（YYYY-MM-DD）
  4. 区分占位符与真实数据 - 明确分离真实数据与说明文字
  5. 维持层级结构 - 通过标题层级体现信息重要性
  6. 善用表格 - 列表数据必须以表格形式呈现

変換時の注意事項

转换注意事项

  • null値は
    [未設定]
    または
    [未記入]
    と表示
  • 日本語と英語のフィールド名が混在する場合は、日本語を優先
  • SprintフィールドはcustomField_10020として取得される
  • Issue keyは必ずリンクまたは強調表示
  • null值显示为
    [未设置]
    或
    [未填写]
  • 若字段名同时存在日语和英语版本，优先使用日语名称
  • Sprint字段将以customField_10020的名称获取
  • Issue key必须设置为链接或高亮显示

使用例

使用示例

例1: プロジェクトのバックログ取得

例1: 获取项目待办事项

「SCRUMプロジェクトのバックログをMarkdownで出力して」
→ JQL検索 + Markdown変換
「将SCRUM项目的待办事项以Markdown格式输出」
→ JQL搜索 + Markdown转换

例2: 個別Issue詳細

例2: 单个Issue详情

「SCRUM-5の詳細をMarkdownで」
→ Issue取得 + Markdown変換
「将SCRUM-5的详情转换为Markdown格式」
→ Issue获取 + Markdown转换

例3: Sprint内容の可視化

例3: Sprint内容可视化

「Sprint 0の内容をまとめて」
→ Sprint検索 + Issue一覧取得 + Markdown変換
「整理Sprint 0的内容」
→ Sprint搜索 + Issue列表获取 + Markdown转换

参考資料

参考资料

  • Atlassian MCP Server Documentation
  • Jira REST API Reference
  • JQL (Jira Query Language) Syntax
  • Atlassian MCP Server Documentation
  • Jira REST API Reference
  • JQL (Jira Query Language) Syntax