extract-pattern について
信頼できるワークフローを再利用可能なパターンとして文書化するスキルです。一般化と再利用テストを行い、適用すべき場合と避けるべき場合も記録します。
主な機能
- 01有効なワークフロー要素の特定
- 02再利用可能なパターンテンプレートの作成
- 03適用条件と非適用条件の記録
- 04類似タスクでのパターン検証
活用シーン
- 01反復を重ねた解決策の整理
- 02有効なプロンプトやツールチェーンの再利用
- 03他プロジェクト向けのエラー処理文書化
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ sharpdeveye/ maestro --skill extract-patternインストール後、Claude Code で/extract-patternを入力して読み込まれたか確認します。
詳細
必須の事前準備
/agent-workflow を呼び出してください。ワークフローの原則、アンチパターン、コンテキスト収集プロトコルが含まれています。先に進む前にプロトコルに従ってください。ワークフローのコンテキストがまだ存在しない場合は、必ず最初に /teach-maestro を実行してください。
うまくいった解決策を、再利用可能なパターンに変えましょう。成功したワークフローにはどれも、元のコンテキスト以外にも適用できるパターンが含まれています。
ステップ 1:うまくいった点を特定する
ワークフローを確認し、次の条件に当てはまる要素を特定します。
- よくある問題を、特に効果的な方法で解決した
- 他のワークフローやプロジェクトでも役立つ
- 正しい形にするまでに大幅な反復が必要だった
- 一見しただけでは分かりにくい解決策を示している
ステップ 2:パターンを一般化する
具体的な解決策を、再利用可能なテンプレートに変換します。
具体例から → 一般的なパターンへ:
## Pattern: [Name]
**Problem**: What recurring problem does this solve?
**When to use**: When is this pattern appropriate?
**When NOT to use**: When is this pattern inappropriate?
**Template**: Copy-pastable starting point with customization markers.
**Variants**: Common variations for different contexts.
**Pitfalls**: What went wrong during development and how it was fixed.
**Examples**: 1-2 concrete examples.
ステップ 3:再利用可能かテストする
- テンプレートを、異なるものの類似した問題に適用する
- カスタマイズ箇所が十分であることを確認する
- 元の内容を知らない人にも、ドキュメントが分かりやすいことを確認する
| ワークフローの要素 | 抽出するもの |
|---|---|
| 効果的なプロンプトの構造 | カスタマイズ箇所を設けたプロンプトテンプレート |
| うまく機能するツールチェーン | データフロー図を含むパイプラインパターン |
| エラー処理戦略 | 実装ガイドを含むレジリエンスパターン |
| 評価手法 | スコアリング基準を含む品質保証パターン |
| コンテキスト管理手法 | 予算に関するガイダンスを含むコンテキストパターン |
| エージェント連携プロトコル | 引き継ぎテンプレートを含むオーケストレーションパターン |
推奨する次のステップ
パターンを抽出したら、/calibrate を実行して、新しいパターンが既存のプロジェクト規約と整合していることを確認してください。
絶対にしてはいけないこと:
- 安定して機能しないワークフローからパターンを抽出する
- 過度に一般化する(1 つのケースにしか適用できない場合は、パターンではなく解決策として記録する)
- 「使用しない場合」のセクションを省略する
- 再利用可能かテストせずに抽出する
コメント
Markdown 対応