| name | ticket-pr |
| description | Jira チケットの調査、実装、ブランチ作成、PR 作成、PR 後フロー開始までを Codex で一貫して進めるときに使う。明示的な `$ticket-pr` 呼び出し専用。 |
Jira チケットから PR を作成
Jira チケットを起点に、要件整理からブランチ作成、実装、検証、コミット、PR 作成、PR 後フロー開始までを一気通貫で進める skill。
使い方
- Codex CLI で
$ticket-pr を選択し、Jira チケットキーまたは URL を渡す
- 例:
$ticket-pr PROJECT-123$ticket-pr https://company.atlassian.net/browse/PROJECT-123
URL が渡された場合は、パスの末尾からチケットキーを抽出する。
前提
- Jira MCP (
mcp__atlassian__*) が利用可能であること
gh がインストール済みで認証済みであること- 現在のリポジトリで作業すること
- 判断記録は Markdown ファイルではなく Jira チケットのコメントに残すこと
ブランチタイプの決定
Jira の課題タイプからブランチタイプを決定する:
| Jira 課題タイプ | ブランチタイプ |
|---|
| Epic / Story / Task / New Feature / Improvement | feat |
| Bug | fix |
| Documentation | docs |
| Refactoring / Technical Debt | refactor |
| Sub-task | 親チケットに準拠、不明なら feat |
ワークフロー
- cloudId を解決する。
- 引数が URL（例:
https://company.atlassian.net/browse/PROJECT-123）の場合: ホスト名（例: company.atlassian.net）を cloudId として使用する
- チケットキーのみの場合:
mcp__atlassian__getAccessibleAtlassianResources で cloudId を取得する
- Jira チケット情報を取得する。
mcp__atlassian__getJiraIssue({ cloudId: "<cloud-id>", issueIdOrKey: "<key>" })- Done / Closed / Resolved 等のステータスの場合は警告を表示し、処理を中断する
- 要件と不確実性を整理する。
- 変更対象
- 想定されるリスク
- 不明点
- 外部仕様が絡む場合は必ず Web 検索や一次情報で確認する
- 実装前の判断を行う。
- 曖昧さが高く、実装を進めると危険ならユーザーに質問する
- そうでなければ合理的な前提を明示して進める
- ブランチを作成する。
git fetch --all --prune- ベースは
origin/master を優先し、存在しなければデフォルトブランチを使う
- ブランチ名は Conventional Branch に従う
- 重要: ブランチ名に Jira チケットキーを含めない（ブランチ名は GitHub PR ページに表示されるため）
- 例:
feat/add-user-authentication
- 実装する。
- dotfiles では
home/ 配下の chezmoi ソースを更新する
- 関連ドキュメントも同期する
- 検証する。
- 最低限、変更内容に対応する syntax / unit / integration テストを実行する
- dotfiles の場合は
tests/ と chezmoi apply 系確認を優先する
- コミットと push を行う。
- Conventional Commits を使い、説明はプロジェクトの CLAUDE.md に従い、指定がない場合は日本語にする
- PR を作成する。
gh-pr-target-repo.sh で PR 作成先のリポジトリを解決するupstream remote が存在する場合は、それを既定の PR 作成先にする- PR 本文はプロジェクトの CLAUDE.md に従い、指定がない場合は日本語で、最新状態のみを記載する
- 更新履歴の羅列は含めない
- 重要: PR のタイトル・本文には Jira チケットキーや Jira への言及を含めない
- Jira チケットに完了コメントを投稿する。
mcp__atlassian__addCommentToJiraIssue({ cloudId: "<cloud-id>", issueIdOrKey: "<key>", commentBody: "<PR URL を含む完了メッセージ>" }) で投稿
- PR 作成後は直ちに
$pr-health-monitor を使う。
- 例:
$pr-health-monitor 456
- restart、agent capacity 不足、または watcher 停止後は
$resume-pr-monitor <PR URL> で pending event を再確認して処理する。
注意事項
- Codex CLI の公式機能では、Claude Code のような任意の custom slash command を追加しない。コマンド相当は skill に置き換える。
- レビュー待ちや CI 待ちの間に別作業へ逸れない。PR 後フローを最後まで回す。
- Jira への言及は GitHub Issues や PR には含めない。Jira チケット側にのみ記録する。
