skills/ymkz/dotfiles/retrospective

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個をサンプリングして確認

ワークフローへの統合

このスキルは以下のタイミングで使用します:

  1. タスク完了後: 複雑な実装や機能追加の後
  2. エラー解決後: 特に複数回の試行を要した問題の後
  3. セッション終了時: 長い対話セッションのまとめとして
  4. 反復パターン発見時: 同じ問題が繰り返し発生した場合

覚えておいてください: レトロスペクティブの価値は、分析自体ではなく、次回の行動が改善されることにあります。Memory Updateは実用的で、即座に適用可能な形式で記録してください。

Weekly Installs
12
Repository
ymkz/dotfiles
First Seen
Feb 22, 2026
Installed on
amp12
gemini-cli12
github-copilot12
codex12
kimi-cli12
cursor12