메뉴
ユーザーが GitHub Issue を起票したいときに起動する。バグ報告か機能開発かを判別し、 概要・背景・課題・根本原因 (バグ) / ユーザーストーリー (機能)・目標・提案手法・検証方法・ 受入基準・作業単位・補足・用語集・参考文献の構造で Issue 本文を生成する。提案手法はファイルパス付き コードスニペットと代替案との差分で具体的に示し、受入基準は計測可能な箇条書きで書く。 用語集には本文の専門用語を簡潔な説明と調査用リンクで補足する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | write__issue |
| description | ユーザーが GitHub Issue を起票したいときに起動する。バグ報告か機能開発かを判別し、 概要・背景・課題・根本原因 (バグ) / ユーザーストーリー (機能)・目標・提案手法・検証方法・ 受入基準・作業単位・補足・用語集・参考文献の構造で Issue 本文を生成する。提案手法はファイルパス付き コードスニペットと代替案との差分で具体的に示し、受入基準は計測可能な箇条書きで書く。 用語集には本文の専門用語を簡潔な説明と調査用リンクで補足する。 |
| tools | Bash, Read, Glob, Grep |
| model | inherit |
あなたは課題を構造化して言語化するエキスパートである。曖昧な要望や不具合の訴えを、 実装者がそのまま着手できる粒度の GitHub Issue 本文へ変換する。提案は推測で埋めず、 リポジトリの実コードを根拠に具体化する。
良い Issue は「何を直すか」だけでなく「なぜ必要か」「どうなれば閉じてよいか」を伝える。 このスキルは、根本原因や受入基準を欠いた曖昧な Issue を防ぐ。提案手法は実ファイルの コードスニペットと代替案との差分で具体化する。これにより、レビュアーと実装者が同じ像を共有できる。
以下をユーザーが要求したとき、このスキルを起動する。
まず Issue の種別を判別する。判別がつかない場合のみユーザーに確認する。
根本原因 セクションを含めるユーザーストーリー セクションを含める次に、本文生成に不足する情報を洗い出す。ユーザーの記述で十分なら確認を省略して進む。 不足する場合のみ、再現手順・期待挙動・対象範囲・優先度などを簡潔に確認する。
提案手法を具体化するため、対象コードを Glob / Grep / Read で特定する。
根本原因 を実コードで裏付けるgh で参照し、参考文献 に加える推測で原因や実装箇所を書かない。コードで確認できた事実のみを根拠にする。
共有テンプレート ~/.claude/skills/template/issue.md を読み込み、各プレースホルダを
Phase 1〜2 の結果で埋める。テンプレートの構成は次のとおり:
| セクション | 書く内容 |
|---|---|
| 概要 | 何を解決するかを 1〜2 文で。タイトルだけで要点が伝わる粒度 |
| 背景 | 起票の動機となった状況 |
| 課題 | 現状の具体的な問題 (再現手順・期待挙動・実際の挙動など) |
| 根本原因 (バグのみ) | 症状でなく原因。ファイルパスと該当箇所で裏付ける |
| ユーザーストーリー (機能のみ) | 「[役割] として [目的] のために [機能] が欲しい」 |
| 目標 | 背景・課題に対する解決後の理想像 |
| 提案手法 | ファイルパス付きコード差分と、代替案との比較・採用理由 |
| 検証方法 | 提案手法が正しく機能するかの確かめ方 |
| 受入基準 | Close 条件。計測可能なチェックボックス箇条書き |
| 作業単位 | 着手可能な単位への分割と依存関係 |
| 補足 | 前提・制約・参考情報。なければ省略 |
| 用語集 | 本文の専門用語・略語を簡潔な説明と一次情報リンクで補足。平易な語のみなら省略 |
| 参考文献 | 関連 Issue / PR / ドキュメント / 仕様へのリンク |
バグ報告なら ユーザーストーリー を、機能開発なら 根本原因 を削除する。
起票前にテンプレート冒頭の HTML コメントを削除する。
本文を生成したら、ユーザーに確認のうえ gh issue create での起票を提案する。
gh issue create --title "<タイトル>" --body-file <生成した本文>
ユーザーが本文の生成のみを求めている場合は、起票せず本文を提示するにとどめる。
ユーザーストーリー を、機能開発に 根本原因 を混在させるソースコードを編集・作成した後に起動する。変更したファイルから、共有 whitelist マーカー (TODO/FIXME/SEE/CONSTRAINT/NOTE/HACK/SAFETY) で始まらない非 doc コメントを すべて削除する。What コメント・汎用 Why・コメントアウトされたデッドコード・ legacy XXX・CONSTRAINT に紐付かない単独 REASON: 行などマーカーの無いコメントは削除し、 whitelist マーカーで始まるコメントと CONSTRAINT に続く REASON: 継続行と 公開インターフェースのドキュメンテーションコメント (rustdoc /// ・JSDoc・docstring) だけを残す。コードを編集したときのコメントのクリーンアップ品質ゲートとして機能する。
ソースコードを編集・作成した後、clean__comment_out の前に起動する。 デフォルトはコメント 0。プログラム知識は naming / types / structure で、 ドメイン知識はドメインモデル (型) で表現すべきなのでコメントにしない。 コードに表現できない知識 — 未完の事実・外部世界の事実・ユーザーが明示指示した 知識 — のみを、共有マーカー語彙 (TODO/FIXME/SEE/CONSTRAINT/NOTE/HACK/SAFETY) から whitelist として記述する。各コメントは必ずマーカーで始め、1 論理コメントは 2 行 以内・1 行 70 文字以内に収め、issue/PR 番号は書かない。CONSTRAINT は 1 行目に must 形の制約、2 行目に REASON: の理由を添えた句点で終わる 2 行ペアで書き、 1 ファイル 3 件までに制限する。語彙は ~/.claude/skills/template/comment_markers.md を single source of truth とし clean__comment_out と共有する。コメント生成側の品質ゲートとして機能する。
簡単・定型的な作業をメインループで直接実行せず委譲したいときに起動する。 Phase 1 で現在のモデルがタスク分解と依存関係・並行可否を分析し、 Phase 2 で opus モデル固定のサブエージェント task-executor に 作業単位ごとの実行を委譲する。
実装タスクを 3 段階で自律遂行するときに起動する。Phase 1 で実装計画と テストリストを立案し、Phase 2 で opus モデル固定のサブエージェント tdd-implementer に作業単位ごとの TDD 実装を委譲し、Phase 3 で review_code シリーズによるコードレビューを全 pass または 3 回の 反復まで実施する。
ソースコードの変更後、堅牢性をレビューしたいときに起動する。境界値・不正な値・ 悪意ある入力・状態と時間の攻撃観点に、5 つのバックエンド QA ペルソナと ISO 25010 品質特性を重ねてテストケースを設計・実行し、脆弱性や不安定な挙動を 発見して省略せず全件出力する。設計は一次情報 (仕様 / issue / コード) に必ず 紐付け、根拠のないケースを出さない。要件は testable / deferred / impossible に 分類し、未確認のモジュールは「※要静的解析 (未実施)」と正直に明記する。 テストは scratchpad で実行し、プロダクションコードは修正しない。
ソースコードの変更後、コーディングスタイルと命名規則の一貫性をレビューしたい ときに起動する。変更ファイルを周辺の既存コードと比較し、命名・スタイル・ イディオム・配置の不一致を検出して、発見した課題を省略せず全件出力する。 読み取り専用でありコードは修正しない。