capture について
captureは、セッションの作業内容を永続的な要約と意思決定ログに記録するMaestroのスキルです。コマンド、決定事項、変更ファイル、課題、次の具体的な作業を整理し、次回のセッションに引き継ぎます。
主な機能
- 01コマンド、決定、ファイル、課題、次の作業を整理
- 02日付付きのセッション要約ファイルを作成
- 03意思決定ログに記録を追加
- 04チェックリストで記録内容を確認
活用シーン
- 01作業セッション終了時のプロジェクト状況保存
- 02後から確認する決定事項と変更ファイルの記録
- 03次回セッションで行う具体的な作業の整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ sharpdeveye/ maestro --skill captureインストール後、Claude Code で/captureを入力して読み込まれたか確認します。
詳細
必須の準備
/agent-workflow を呼び出してください。ワークフローの原則、アンチパターン、コンテキスト収集プロトコルが含まれています。作業を進める前にこのプロトコルに従ってください。ワークフローのコンテキストがまだない場合は、必ず先に /teach-maestro を実行してください。
現在のセッションでの作業内容を、永続的な要約として記録してください。これにより、セッションをまたいで残る記録が作成され、以後のコマンドから今回の内容を参照できるようになります。
記録する内容
会話履歴を読み、次の項目を特定してください。
- 実行したコマンド — 呼び出した Maestro コマンドとその順序
- 決定事項 — アーキテクチャ上の選択、受け入れたトレードオフ、採用したパターン
- 変更したファイル — 作成、変更、削除したもの
- 発見した問題 — 特定したバグ、不足、リスク
- 次のステップ — 次に行うべきこと(具体的に)
出力形式
.maestro/sessions/{date}_{topic}.md にセッション要約ファイルを作成してください。
# Session: {topic}
Date: {YYYY-MM-DD}
## Commands Run
- /diagnose → Score: 18/25
- /fortify → Added retry logic to API handlers
- /evaluate → Verified with 3 test scenarios
## Decisions
- Chose retry-with-backoff over circuit breaker (simpler, sufficient for current load)
- Kept synchronous error handling (async not justified yet)
## Files Changed
- `src/api/handler.ts` — added retry wrapper
- `src/middleware/auth.ts` — added input validation
- `tests/api.test.ts` — new test file
## Open Issues
- Rate limiting not yet implemented (deferred to next session)
## Next Steps
1. Run `/guard` to add rate limiting
2. Run `/evaluate` with adversarial test cases
さらに、この記録についての決定事項を .maestro/decisions.jsonl に追記してください。
セッション記録のチェックリスト
- このセッションで実行したコマンドをすべて記載した
- 重要な決定事項とその理由を記録した
- 変更したファイルを簡単な説明とともに列挙した
- 未解決の問題を記録した(何も失われていない)
- 次のステップを具体的かつ実行可能な内容にした
- 要約を
.maestro/sessions/に保存した
推奨する次のステップ
記録後、次のセッションでは /recap から始めてコンテキストを復元し、上記の次のステップに進んでください。
絶対に行わないでください:
- 生のプロンプトや LLM の出力全体をセッションファイルに保存する
- 既存のセッションファイルを上書きする — 新しいファイルを作成する
- 「次のステップ」セクションを省略する — これが記録を有用にします
- 会話履歴を先に読まずに記録する
- ユーザーがこのコマンドを呼び出していないのに、自動で記録する
コメント
Markdown 対応