mcpField
C
capture

capture

github.com/sharpdeveyeエージェントワークフロー592238 回インストール26 週間前に更新
リポジトリ

capture について

captureは、セッションの作業内容を永続的な要約と意思決定ログに記録するMaestroのスキルです。コマンド、決定事項、変更ファイル、課題、次の具体的な作業を整理し、次回のセッションに引き継ぎます。

主な機能

  1. 01コマンド、決定、ファイル、課題、次の作業を整理
  2. 02日付付きのセッション要約ファイルを作成
  3. 03意思決定ログに記録を追加
  4. 04チェックリストで記録内容を確認

活用シーン

  1. 01作業セッション終了時のプロジェクト状況保存
  2. 02後から確認する決定事項と変更ファイルの記録
  3. 03次回セッションで行う具体的な作業の整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sharpdeveye/maestro --skill capture

インストール後、Claude Code で/captureを入力して読み込まれたか確認します。

詳細

必須の準備

/agent-workflow を呼び出してください。ワークフローの原則、アンチパターン、コンテキスト収集プロトコルが含まれています。作業を進める前にこのプロトコルに従ってください。ワークフローのコンテキストがまだない場合は、必ず先に /teach-maestro を実行してください。


現在のセッションでの作業内容を、永続的な要約として記録してください。これにより、セッションをまたいで残る記録が作成され、以後のコマンドから今回の内容を参照できるようになります。

記録する内容

会話履歴を読み、次の項目を特定してください。

  1. 実行したコマンド — 呼び出した Maestro コマンドとその順序
  2. 決定事項 — アーキテクチャ上の選択、受け入れたトレードオフ、採用したパターン
  3. 変更したファイル — 作成、変更、削除したもの
  4. 発見した問題 — 特定したバグ、不足、リスク
  5. 次のステップ — 次に行うべきこと(具体的に)
出力形式

.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 の出力全体をセッションファイルに保存する
  • 既存のセッションファイルを上書きする — 新しいファイルを作成する
  • 「次のステップ」セクションを省略する — これが記録を有用にします
  • 会話履歴を先に読まずに記録する
  • ユーザーがこのコマンドを呼び出していないのに、自動で記録する

コメント