mcpField
R
reflect

reflect

github.com/mariusflorescuエージェントワークフロー1288 回インストール4 日前に更新
リポジトリ

reflect について

会話から再利用できる学びを抽出し、スキルの編集またはバックログへ振り分けるスキルです。3つの視点による並行レビューと統合を行い、採用した変更の適用前に承認を求めます。

主な機能

  1. 01現在の会話記録の特定
  2. 023つの視点による並行レビュー
  3. 03採用・却下・バックログ項目の整理
  4. 04スキル編集前の承認必須化
  5. 05承認済み編集の規模別振り分け

活用シーン

  1. 01会話から再利用可能な学びを抽出
  2. 02学びをスキルかバックログかに振り分け
  3. 03明示的な承認に向けたスキル変更の準備

インストール

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

$npx skills add https://github.com/mariusflorescu/pstack-t3 --skill reflect

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
divergent-reviewer.md
judgment-reviewer.md
synthesizer.md
tooling-reviewer.md

詳細

Reflect

太字またはバッククォートで示されたスキル名、あるいは /<name> として実行されるスキル名は、このスキルのディレクトリと同じ階層にある ../<name>/SKILL.md を指します。接頭辞なしで示された原則名は、../principle-<name>/SKILL.md を指します。そのファイルを読み、内容に従ってください。pstack のスキルのほとんどはユーザー専用のため、スキルツールでは読み込めません。すべての delegate_task 呼び出しには、../poteto-mode/SKILL.md の「Subagents」セクションにあるデフォルト設定が適用されます。

現在の会話から長く役立つ学びを掘り起こし、スキルの編集に反映してください。

ユーザーが「reflect」または「/reflect」と言ったときに呼び出してください。会話が些細な内容、無関係な内容、または親スキルがすでに正しく対応している既存のスキルの範囲内であれば、実行しないでください。一度限りの出来事は学びではありません。

1. アクティブなトランスクリプトを特定する

並列処理を開始する前に、この会話のスレッドを見つけてください。会話の最初のユーザープロンプトから特徴的なフレーズを使い、t3_thread_search でこのプロジェクトを検索します。別のプロジェクトの projectId を渡してはいけません。ワークスペースの境界を越え、無関係なプロジェクトのプライベートなチャットを読み込むことになります。

候補ごとに、t3_thread_read で最初のユーザーメッセージを読みます。最初のメッセージがこの会話の開始時のユーザープロンプトと一致する threadId を選んでください。一致するものがない場合は、セッションの簡潔な要約を渡します。

2. 3 人のレビュアーを並列で起動する

1 回のターンで、各レビュアーの役割行にある title と target を指定して、3 回の delegate_task を呼び出します。レビュアーがトランスクリプトで参照されているチケット、チャットスレッド、オブザーバビリティのトレースを調べられるよう、MCP へのアクセス権を付与します。

各レビュアーと統合担当者は、~/.config/pstack/pstack-models.md にある役割行で指定します。ファイルがない場合、または役割行がない場合、その役割は親モデルで実行してください。その旨を伝え、/setup-pstack を提案します。orchestrator_capabilities に設定済みの項目がない場合、その役割は親モデルで実行し、その旨を伝えてください。Subagents セクションにある poteto-mode スキルの指示に従い、作業に適した推論レベルと高速または標準の実行速度を各サブエージェントに選びます。

レンズ役割行プロンプトテンプレート
判断reflect judgment, divergent, synthesizerreferences/judgment-reviewer.md
ツール利用reflect toolingreferences/tooling-reviewer.md
発想の広がりreflect judgment, divergent, synthesizerreferences/divergent-reviewer.md

各テンプレートをそのままブリーフとして渡し、指定箇所にスレッド ID または要約を挿入します。レビュアーはタスクの結果として所見を返します。

3. 統合する

Reflect synthesizer というタイトルと、reflect judgment, divergent, synthesizer の行から取得した target を指定して、delegate_task を 1 回呼び出します。MCP を通じて引用を確認します。各レビュアーの出力全文を指定箇所に挿入し、references/synthesizer.md をそのまま渡します。Accepted / Rejected / Backlog の一覧が返されます。

4. 構造による適用を確認する

リンタールール、スクリプト、メタデータフラグ、またはランタイムチェックによって、より確実に適用できる Accepted 項目があれば、Backlog に移してください。encode-lessons-in-structure の原則スキルを参照してください。

5. 適用する

シンセサイザーが出力した「採用」「却下」「バックログ」の全項目を提示し、「採用」された編集を適用する前に、明示的な承認を待ちます。ユーザーは適用する項目を選択でき、ルーティングを変更することもできます。スキルの変更は、組織内の今後すべてのエージェントに影響します。自動適用してはいけません。

バックログの各項目は、待たずにチームの devex またはバックログトラッカーに登録します。承認を待つのは「採用」リストのみです。

承認された各行のルーティングに正確に従います。

  • 既存スキルへの軽微な編集(一行の箇条書き、文の簡潔化、古くなった事実の修正):親が直接実施します。
  • 既存スキルへの実質的な編集(新しいセクション、新しいパターン表、約10行を超える変更):skill-creator スキルに引き継ぎ、ドラフト/テスト/反復のループを実行します。
  • tune description: <skill path>(スキルは存在するが、必要なときに起動しなかった):skill-creator に引き継ぎ、説明の最適化ループを実行します。
  • new skill via skill-creator: <kebab-name>:スキルの作成を skill-creator に引き継ぎます。場当たり的に構成を考案してはいけません。

skill-creator がインストールされていない場合は、ルーティングで指定されている箇所に限り、スキル作成プレイブック(../poteto-mode/playbooks/authoring-a-skill.md)に従います。

環境に SKILL.md バリデーターがある場合は、完了を宣言する前に、変更したすべてのスキルに対して実行します。

6. ユーザー向けに要約する

前置きなしで、簡潔なリストを示します。

  • 適用した編集:<skill path>。変更内容を各一行で記載します。
  • 作成した新しいスキル:<skill path>。各一行で記載します(まれです)。
  • devex トラッカーに登録したバックログ:<issue title>(<tags>)。各一行で記載します。
  • 見送った項目:却下された指摘と、シンセサイザーが示した理由を一件につき一行で記載します。

コメント