Menu
Issue作成とラベル付与を行う。開発ワークフローの起点。review-ready 7観点を満たす本文生成を誘導する。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
dev workflow 向けの最終チェック。PR 前に品質ゲート、docs 整合、設計書昇格、Issue 更新をまとめて確認する。
docs-only workflow 向けの最終チェック。docs 整合と Issue 状態を確認し、PR に進めるか判定する。
docs review の指摘に対応し、ドキュメントのみを修正する。コードやテストは変更しない。
docs-only の変更をレビューし、事実整合性・実装整合性・運用整合性の観点から判定する。
docs-only の更新を行う。コードやテストは変更せず、現行実装・CLI・運用方針との整合を確認しながら docs を修正する。
docs review の指摘が適切に修正されたかを確認する。新規指摘は行わない。
| description | Issue作成とラベル付与を行う。開発ワークフローの起点。review-ready 7観点を満たす本文生成を誘導する。 |
| name | issue-create |
GitHub Issue を作成し、適切なラベルを付与する。
本スキルは issue-review-ready（.claude/skills/issue-review-ready/SKILL.md のチェック観点1〜7）で RETRY にならない水準の本文を生成することを目標とする。単なるテンプレ埋めではなく、「何を」「どこに」「なぜ」「何が満たされれば完了か」「その根拠」を明示できるまで対話で不足を補う。
| タイミング | このスキルを使用 |
|---|---|
| 新機能・バグ修正・リファクタの着手前 | ✅ 必須 |
| 既存Issueがある場合 | ❌ 不要 |
ワークフロー内の位置: create → review-ready → start → ...
$ARGUMENTS = <title> [type] [description]
title (必須): Issue タイトルtype (任意): feat / fix / refactor / docs / test / chore / perf / security（デフォルト: feat）description (任意): 詳細説明。省略時は対話で収集。| type | ラベル | 用途 |
|---|---|---|
feat | type:feature | 新機能追加 |
fix | type:bug | バグ修正 |
refactor | type:refactor | リファクタリング |
docs | type:docs | ドキュメント |
test | type:test | テスト追加・改善 |
chore | type:chore | 雑務・依存の掃除 |
perf | type:perf | パフォーマンス改善 |
security | type:security | セキュリティ対応 |
$ARGUMENTS から title, type, description を取得する。
type が未指定なら feat をデフォルトとするdescription が未指定または情報不足なら、ユーザーに対話で詳細を確認する本文起草の前に、以下が揃っているかを確認する。不足している場合は 対話で補う、またはコマンド実行・ファイル閲覧で事実を確認する。推測で埋めない。
| # | 観点（review-ready） | 収集する情報 |
|---|---|---|
| 1 | 構造の完備 | 概要・目的・完了条件の3セクションを埋める材料 |
| 2 | 概要の具体性 | 「何を」「どこに」: 対象モジュール / ディレクトリ / ファイルパス、対象ドキュメントパス |
| 3 | 目的の根拠 | 背景・動機: 既存コード/ドキュメント/運用で困っている具体的事象 |
| 4 | 完了条件の検証可能性 | 客観的に判定可能な条件（CLI 実行結果、ファイル存在、テスト通過、docs 整合等） |
| 5 | 1次情報の明示 | 外部 URL、docs/ パス、関連 Issue/PR 番号、ログ、CLI 出力のいずれか |
| 6 | 記述間の整合性 | 概要・目的・完了条件が互いに矛盾しないこと |
| 7 | 作業スコープの推定可能性 | dev: 対象ファイル/ディレクトリ/技術スタック。docs-only: 対象ドキュメントパスまたは領域 |
補強のヒント:
make check 通過」）Step 1 で確定した type に応じて、以下のテンプレートファイルを Read ツールで読み込み、その本文構造に従って Issue 本文を組み立てる。
| type | テンプレートファイル |
|---|---|
feat | .claude/skills/issue-create/templates/issue-feat.md |
fix | .claude/skills/issue-create/templates/issue-bug.md |
refactor | .claude/skills/issue-create/templates/issue-refactor.md |
docs | .claude/skills/issue-create/templates/issue-docs.md |
canonical 外 type のフォールバック: test / chore / perf / security を受け取った場合は issue-feat.md を使用する（dispatch 方式の制約）。
dispatch 方式: パターン A（Read ツールによる静的選択読み）を採用。SKILL.md は薄く保ち、テンプレート本文は外部ファイルで管理する。
各テンプレートには「本文の雛形」に加えて、type 特有のチェックポイント（例: feat のユースケース、bug の OB/EB、refactor の測定指標、docs の対象パス）が記載されている。テンプレート末尾の「チェックポイント」を対話で必ず確認してから本文を確定する。
共通の追記ルール（全 type 共通）:
draft/design/issue-<issue_id>-<slug>.md を参考欄に予告してもよいuv run kaji issue create --title "[title]" --body "[body]" --label "[label]"
以下の形式で報告すること。
## Issue 作成完了
| 項目 | 値 |
|------|-----|
| Issue | [issue_ref] |
| タイトル | [title] |
| Type | [type] |
| ラベル | [label] |
| URL | [issue-url] |
### 次のステップ
作業を開始するには `/issue-review-ready [issue_id]` でレディネスレビューを実行してください。
実行完了後、以下の形式で verdict を出力すること。
---VERDICT---
status: PASS
reason: |
Issue 作成成功
evidence: |
Issue [issue_ref] を作成、ラベル付与済み
suggestion: |
---END_VERDICT---
重要: verdict は stdout にそのまま出力 すること。Issue コメントや Issue 本文更新とは別に、最終的な verdict ブロックは stdout に残す。
| status | 条件 |
|---|---|
| PASS | Issue 作成成功 |
| ABORT | 作成失敗、または review-ready の観点に必要な素材が対話でも揃わない |