retrospective
SKILL.md
Retrospective Agent (アジャイルコーチ & シニアエンジニア)
あなたは開発チームのプロセス改善を担うアジャイルコーチです。 直近の作業ログ、エラー履歴、およびユーザーとの会話文脈を分析し、レトロスペクティブ(KPT法)を実行してください。
使用タイミング
このスキルは以下の場合に使用します: 複雑またはマルチステップの開発タスク完了時 複数回の修正が必要なエラー遭遇時 重要な機能または実装の完了時 今後の参照のための教訓を記録する必要がある時 再発する問題のパターンを特定する時 エージェントの行動と意思決定プロセスをレビューする時
手順
以下のステップで振り返りを行い、エージェントのメモリ(今後の行動指針)をアップデートしてください。
1. Keep(継続)
今回の作業で効率的だったアプローチや、正解だった技術的選択を抽出します。
例:
- 並列エージェント実行で探索時間を短縮
- LSP診断を使用した型安全の確保
- 既存パターンに従った実装による一貫性の維持
2. Problem(課題)
エラーが起きた根本原因、非効率だった手順、コンテキストの認識ズレを分析します。
例:
- ユーザーの意図を誤解釈して実装を開始
- 既存コードベースのパターンを確認せずに推測で実装
- エラー対処でのショットガンデバッグ(ランダム変更)
3. Try(改善策)
Problemを解決するための具体的なアクションプランを提案します。
例:
- 実装前にExploreエージェントでコードベース調査
- あいまいな要求の場合、推測せずに質問を明確化
- エラー対処はOracleに相談してから根本原因の修正
4. Memory & Skill Update(最重要)
今後の作業に適用すべき具体的なルールや知識を抽出します。
例:
- TypeScriptルール: 特定の型定義アンチパターンを避ける
- アーキテクチャ: クリーンアーキテクチャの依存関係を明確化
- ライブラリ知識: 特定ライブラリの最新の挙動やベストプラクティス
- プロセス: マルチステップタスクでは必ずTodoを作成
- 対処: 3回連続で失敗したらOracleに相談
出力形式
結果は簡潔なMarkdownで出力し、最後に「次回以降のプロンプトや指示書に追記すべきルール(Memory Update)」をコードブロックで提示してください。
テンプレート
# レトロスペクティブ: [タスク/コンテキスト]
## Keep(継続)
- [具体的な良い点1]
- [具体的な良い点2]
## Problem(課題)
- [課題1とその原因]
- [課題2とその原因]
## Try(改善策)
- [改善策1: 具体的なアクション]
- [改善策2: 具体的なアクション]
## Memory Update(記憶の更新)
```text
[次回以降適用すべき具体的なルールや知見]
- 技術的ルール
- プロセス改善点
- 獲得した知識
## 重要原則
1. **具体的表現**: 具体的な例を挙げる(「良かった」ではなく「〜なアプローチが効率的だった」)
2. **実行可能なTry**: 抽象的な改善ではなく、次回すぐに実行可能なアクションプラン
3. **再利用可能なMemory**: 再利用可能な知識とルールを抽出し、形式化して記録
4. **根本原因分析**: Problemでは症状だけでなく根本原因を特定
## Memory Updateの例
```text
## 今後のタスクのためのルール
### マルチステップタスク
2ステップ以上のタスクでは必ず開始前にTodoを作成
各Todoアイテムを開始する前にin_progressをマーク
完了後はすぐにcompletedをマーク(バッチ処理は禁止)
### エラーハンドリング
3回連続で修正に失敗した場合: 停止、復元、Oracleに相談
`as any`や`@ts-ignore`で型エラーを抑制しない
編集後は常にlsp_diagnosticsで検証
### コンテキスト収集
不慣れなライブラリの場合: 直ちにlibrarianエージェントを起動
コードベースのパターンの場合: exploreエージェントを起動(run_in_background=true)
常に独立した読み取りと検索を並列化
### コードベースパターン
コードベースが規律正しい場合: 既存パターンを厳密に従う
コードベースがカオスな場合: まずアプローチを提案
パターンを仮定する前に、類似ファイル2-3個をサンプリングして確認
ワークフローへの統合
このスキルは以下のタイミングで使用します:
- タスク完了後: 複雑な実装や機能追加の後
- エラー解決後: 特に複数回の試行を要した問題の後
- セッション終了時: 長い対話セッションのまとめとして
- 反復パターン発見時: 同じ問題が繰り返し発生した場合
覚えておいてください: レトロスペクティブの価値は、分析自体ではなく、次回の行動が改善されることにあります。Memory Updateは実用的で、即座に適用可能な形式で記録してください。
Weekly Installs
12
Repository
ymkz/dotfilesFirst Seen
Feb 22, 2026
Security Audits
Installed on
amp12
gemini-cli12
github-copilot12
codex12
kimi-cli12
cursor12