القائمة
Issue作成とラベル付与を行う。開発ワークフローの起点。review-ready 7観点を満たす本文生成を誘導する。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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 の観点に必要な素材が対話でも揃わない |