Menu
セッションのふりかえりをKPTA形式で実施し、設定の改善提案と即時実施を行う。 「ふりかえり」「レトロスペクティブ」「retrospective」「振り返り」「KPT」「KPTA」 「今日のセッションを振り返って」「改善提案して」のように使う。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | x-retrospective |
| description | セッションのふりかえりをKPTA形式で実施し、設定の改善提案と即時実施を行う。 「ふりかえり」「レトロスペクティブ」「retrospective」「振り返り」「KPT」「KPTA」 「今日のセッションを振り返って」「改善提案して」のように使う。 |
| context | fork |
| allowed-tools | ["Bash","Read","Write","Edit","Glob","Grep","AskUserQuestion","Agent","TaskCreate","TaskUpdate","TaskList"] |
セッションを振り返り、「今すぐ直せる設定変更」を提案・実施する。 記録は副産物。メインは改善の実施。
フローを開始する前に、全ステップをTaskCreateで登録します。各ステップを開始するときTaskUpdateでin_progressへ、完了したときcompletedへ更新します。
| # | subject | blockedBy |
|---|---|---|
| 1 | Step 1: retrospectiveファイルを読み込む | — |
| 2 | Step 2: セッション内容を整理する | 1 |
| 3 | Step 3: KPTA分析 | 2 |
| 4 | Step 4: 改善提案を生成する | 3 |
| 5 | Step 5: 改善を実施する | 4 |
| 6 | Step 6: retrospectiveファイルにT/Aと結果を追記する | 5 |
セッションで使われたretrospectiveファイルを読み込む。 最後に更新されたファイルを使う（セッションが日をまたぐ場合も対応）。
latest=$(ls -t retrospective/[0-9]*.md 2>/dev/null | head -1)
cat "$latest" 2>/dev/null || echo "(記録なし)"
会話コンテキストとretrospectiveファイルを振り返り、以下の観点で気づきを拾う。
| 観点 | 確認内容 |
|---|---|
| 繰り返しのブロック | 同じ deny / ask が複数回発生したか |
| 繰り返しの承認 | 同じ permission を何度も許可したか |
| 繰り返しの指示 | 同じ指示・判断基準を複数回伝えたか |
| 定型化したワークフロー | 毎回同じ手順で作業したか |
| 手動で繰り返し呼んだスキル | 同じスキル・エージェントを毎回手動で実行したか |
| 新ツール導入 | 新しいコマンド・サービスを使い始めたか |
| 遅いフィードバック | CI のみになっているチェックがあるか |
| うまくいった判断 | 続けるべき良いアプローチがあったか |
実施したタスクの概要と、上記の観点で見つかった改善候補をユーザーに提示して確認を取る。
| カテゴリ | 着眼点 |
|---|---|
| Keep | 続けるべき良い判断・アプローチ（さらに強化・仕組み化できるものはTry/Actionへ） |
| Problem | Step 2 の気づきから原因を掘り下げる |
| Try | 改善につながりそうなアイデア（量重視） |
| Action | 次のセッションで確実に実行できる具体的な施策 |
Problemの各項目は以下のフォーマットで整理する。改善先はStep 4の判断テーブルを参照する。
### [P-N] タイトル
- 状況: いつ・どこで何が起きたか
- 問題: 何がどうなってしまったか
- 原因: 何が再現条件か
- 改善先: hooks / CLAUDE.md / rules / skills / settings.json / agents
- 対策: 改善先に対して何をどう変えるか
Step 3のProblem（改善先・対策）をもとに、具体的なファイルパスと変更内容を決める。
| 症状 | 改善先 |
|---|---|
| 同じ deny / ask が複数回発生した | hooks/pre-tool-use/ にルールを追加 |
| 編集してはいけないファイル（設定・鍵・lockファイル等）が file-protect.sh に漏れていて編集された | hooks/pre-tool-use/file-protect.sh にパターン追加 |
| 同じ permission を何度も承認した | settings.json の allow に昇格 |
| すべての会話に共通する制約（短く書ける） | CLAUDE.md に追記 |
| 特定のファイル種別を編集するときだけ必要 | rules/ に追加（paths: で適用範囲を絞る） |
| 毎回同じ手順・明示的に呼び出す | skills/ に切り出す（/skill-creator を使う） |
| 状況で判断が変わる・自律的に動かす | agents/ に切り出す |
| 新しいツール・サービスを使い始めた | settings.json の allow/deny に追加 |
| フィードバックが遅い・CI のみになっている | hooks/post-tool-use/ に移す |
| スキル・エージェントを毎回手動で呼び出している | UserPromptSubmit フックで自動化できないか検討する |
#### [改善提案-N] タイトル
- 対象: hooks / CLAUDE.md / rules / skills / settings.json / agents
- 対象ファイル: 具体的なパス
- 内容: 何をどう変更・追加するか
- メリット: この改善によって何が変わるか
- デメリット: 制約・副作用・注意点
AskUserQuestionで確認する。
{
"question": "改善提案の中で、このセッション中に実施するものを選んでください",
"options": [
{ "label": "実施する", "description": "どの提案を実施するか選んで今すぐ実装する" },
{ "label": "記録のみ", "description": "retrospective ファイルに記録して次回以降に持ち越す" }
]
}
「実施する」が選択された場合、以下を直接実行する。
| 改善対象 | 実施方法 |
|---|---|
| hooks にルール追加 | 対象ファイルを編集 |
| CLAUDE.md / rules/ に追記 | 該当ファイルを編集 |
| 新スキル作成 | /skill-creator を呼び出す |
| settings.jsonのallow昇格 | settings.json を編集 |
ディレクトリが存在しない場合は先に作成する。
mkdir -p retrospective
retrospective/YYYY-MM-DD.md にTry/Actionと実施結果を追記する（ファイルがなければ作成）。
## Try
- <箇条書き>
## Action
<Step 3 の Action 項目>
## 改善提案と実施結果
<Step 4・5 の内容と実施結果>
Gitコミットを適切な粒度に分割し、有用なメッセージを付けて作成するスキル。「コミットして」「commitして」「変更をコミット」「まとめてコミット」など、コミット操作を依頼されたら必ず使う。
指定したスキルを3回繰り返し適用します。レビュー・計画・実装など、ファイルを変更するスキルに使います。「iterateで<スキル名>して」「<スキル名>を繰り返し適用して」のように使います。
既存テストをレビューして改善するスキル。「テストをレビューして」「テストを改善して」「テスト名を直して」のように頼まれたら使う。新規にテストを書くのではなく、`.claude/docs/test-implementation.md` のルール（テスト名・AAA構造・アサーション設計・テストダブル・非決定性制御・テスト間独立性・Testing Library 等のフロントエンド固有ルールまで全観点）に既存テストが沿っているかを見直す。対象は `.test.ts` / `.test.tsx` / `.spec.ts` ファイルと、テストコードブロックを含む `.md` ドキュメントファイル。
作った成果物について、ユーザーがその振る舞いと目的を確実に理解できているかを問いかけで確認します。細かな実装ではなく、何をするものか・目的にかなうかに焦点を当て、あらゆる可能性を踏まえてエージェントが判断して問いを立てます。「理解できているか確認して」「振る舞いを確認して」「目的にかなっているか見て」「作ったあとのすり合わせをして」と要望された際に必ず使用します。実装や変更が一段落したとき、作ったものの理解をすり合わせたいと感じたら積極的に提案してください。
`/compact`で要約する前に、残したい情報をユーザーに選んでもらい`/compact`の引数を組み立てます。 「compact前に整理したい」「コンテキストを圧縮したい」「/compactの引数を作って」 「会話が長くなってきたので整理したい」「重要な情報を引き継ぎたい」のように使います。
マージ済みのローカル・リモートブランチを整理するスキル。「ブランチ掃除」「マージ済みブランチを削除」「ブランチ整理」「gh poiを実行」「不要なブランチを片付けて」「リモートのブランチも消したい」「mainだけ残して」のような依頼で必ず使う。gh-poi拡張がインストール済みであることを前提とする。mainなどベースブランチは絶対に削除しない。