octkp/ba2-process-improvement-ticket

ba2 Process Improvement Ticket

JIRA の BigAdvance（BAX）プロジェクトに「プロセス改善」種別のチケットを作成するスキル。チーム運用・開発フロー・ツールなどの改善提案を、決まったフォーマット（課題 / 解決方法 / ゴール）で起票する。

このスキルは Atlassian Rovo MCP（mcp__claude_ai_Atlassian_Rovo__*）への接続が必要。未接続の場合は作成できないので、その旨を伝えて終了する。

前提・確定値（実 JIRA から取得済み・推測しない）

スキル作成時に kokopelli-inc.atlassian.net の実メタデータから取得した確定値。これらの ID は実在の設定であり、勝手に変更しない。

| 項目 | 値 | 種別 | |---|---|---| | cloudId | c385675e-ad43-416a-b082-a53d42cd1fdc | （getAccessibleAtlassianResources で再取得も可） | | プロジェクト | BAX（id 10027 / BigAdvance） | 必須 | | 課題タイプ | プロセス改善（issuetype id 10701） | 必須 | | 要約 | summary | 必須・string | | 課題 | customfield_10610 | 任意・textarea | | 解決方法 | customfield_10612 | 任意・textarea | | ゴール | customfield_10613 | 任意・textarea | | 起票者 | customfield_10615 | 任意・user（実行者を自動セット） | | （参考）改善した結果 | customfield_10614 | 任意・textarea。起票時は通常空 | | （参考）プロセス改善ラベル | customfield_10611 | 任意・labels |

cloudId はハードコードしてあるが、万一変わっていた場合に備え、エラー時は mcp__claude_ai_Atlassian_Rovo__getAccessibleAtlassianResources で kokopelli-inc.atlassian.net の UUID を取り直す。

入力

ユーザーから以下を受け取る（会話の流れから読み取れるものは聞き直さない）:

• 要約（summary）: チケットのタイトル。必須。1 行で簡潔に。
• 課題: 何が問題か。現状の困りごと・非効率・リスク。
• 解決方法: どう改善するか。具体的な施策・手順。
• ゴール: 改善後にどうなっていれば成功か。できれば定量・定性の達成基準。

不足している項目があれば、自然文で尋ねて補う（特に要約は必須）。会話の文脈から十分に埋められる場合は、ドラフトを作ってプレビュー時に確認してもらう。

ワークフロー

Step 1: Rovo 接続と起票者の解決

1. 起票者にセットする自分の accountId を取得する:

   mcp__claude_ai_Atlassian_Rovo__atlassianUserInfo()
   

   • 返ってきた account_id（または accountId）を customfield_10615 に使う。
   • 取得に失敗した場合は起票者を省略して続行する（任意項目なのでブロッカーにしない）。

2. Rovo に接続できない場合は「Atlassian Rovo に接続できないため、プロセス改善チケットを作成できません。」と伝えて終了。

Step 2: 4 項目を組み立てる

要約・課題・解決方法・ゴールを確定する。各 textarea は Markdown で読みやすく整形してよい（箇条書き等）。空の項目は無理に埋めず空のままでよい（任意項目）。

Step 3: プレビューと確認（必須）

作成前に、以下の形でチャットにプレビューを提示し、ユーザーの明示的な承認を得てから Step 4 に進む。

## 作成するプロセス改善チケット（プレビュー）
- プロジェクト: BAX (BigAdvance)
- 種別: プロセス改善
- 起票者: {自分の表示名 / accountId}

### 要約
{summary}

### 課題
{課題}

### 解決方法
{解決方法}

### ゴール
{ゴール}

「この内容で作成しますか？」と尋ねる。修正指示があれば反映して再提示する。

Step 4: チケット作成

承認を得たら mcp__claude_ai_Atlassian_Rovo__createJiraIssue で作成する。 カスタムフィールドは additional_fields にまとめて渡す（このパラメータが唯一のカスタムフィールド設定手段）。

mcp__claude_ai_Atlassian_Rovo__createJiraIssue(
  cloudId       = "c385675e-ad43-416a-b082-a53d42cd1fdc",
  projectKey    = "BAX",
  issueTypeName = "プロセス改善",
  summary       = "{summary}",
  additional_fields = {
    "customfield_10610": "{課題}",
    "customfield_10612": "{解決方法}",
    "customfield_10613": "{ゴール}",
    "customfield_10615": { "accountId": "{自分のaccountId}" }
  }
)

• issueTypeName は "プロセス改善"（id で渡したい場合は additional_fields に "issuetype": {"id": "10701"}）。
• 起票者を取得できなかった場合は customfield_10615 を含めない。
• 空の項目（課題・解決方法・ゴールのいずれかが未入力）は、そのキーを含めない（空文字を送らない）。
• description（標準の説明欄）は通常使わない。課題/解決方法/ゴールの3フィールドで完結させる。必要ならユーザーに確認のうえ補助的に使ってよい。

Step 5: 結果報告

• 作成された課題キー（例: BAX-XXXXX）と URL（https://kokopelli-inc.atlassian.net/browse/BAX-XXXXX）をチャットに提示する。
• 作成に失敗した場合はエラー内容を表示する。フィールド ID 起因のエラーなら、getJiraIssueTypeMetaWithFields（projectIdOrKey=BAX, issueTypeId=10701）で最新のフィールド定義を取り直して照合する。

エラーハンドリング

| 状況 | 対応 | |------|------| | Rovo 未接続 | 作成できない旨を伝えて終了 | | 要約が未指定 | 必須なので自然文で尋ねる | | 起票者 accountId 取得失敗 | customfield_10615 を省略して続行（任意項目） | | cloudId が無効 | getAccessibleAtlassianResources で取り直す | | カスタムフィールド ID エラー | getJiraIssueTypeMetaWithFields(BAX/10701) で最新定義を取得し照合 |

やらないこと

• 確認なしのチケット作成（Step 3 のプレビュー承認を必ず経る）。
• ID の推測・捏造（フィールド ID は本ファイルの確定値、または実メタデータ取得で得たものだけを使う）。
• BAX 以外のプロジェクト・「プロセス改善」以外の種別への流用（このスキルは BAX のプロセス改善専用）。

使用例

ユーザー: 「レビュー依頼の手順がバラバラで時間がかかってる問題、プロセス改善チケットにして」

実行:

1. atlassianUserInfo で自分の accountId を取得
2. 会話から 課題（手順バラバラで時間がかかる）/ 解決方法 / ゴール を組み立て、要約を起こす
3. プレビューを提示して「この内容で作成しますか？」と確認
4. 承認後 createJiraIssue（種別=プロセス改善、課題/解決方法/ゴール/起票者をセット）
5. 作成された BAX-XXXXX の URL を報告