reflect

reflect skill の概要

reflect は何のためのものか

reflect は Skill Validation 用のスキルで、二段階目のレビューに使います。完成済み、またはほぼ完成の応答を受け取り、見落とした欠陥、弱い推論、過信気味の承認がないかを強めに जांचします。reflect skill が特に役立つのは、新しい解答を作ることではなく、素早く、しかし慎重に品質ゲートを通したいときです。

どんな人に向いているか

AI生成物をレビューする人、本番向けの回答を出す人、あるいは「これは通してよいか」を дисциплинированно 確認したい人に reflect は向いています。過去の出力とタスク文脈を一緒に渡せるエージェントなら相性が良いです。ブレストや下書き支援が欲しいなら、このスキルは適していません。

何が違うのか

このスキルは、複雑さの切り分け、信頼度チェック、検証志向のフィードバックを軸に設計されています。つまり reflect install の価値は、どこまで深く見るべきかをモデルに判断させ、失敗しやすい箇所に重点的に目を向けさせる点にあります。文体を整えるためというより、欠陥が広がる前に見つけることに重きがあります。

reflect skill の使い方

reflect をインストールして、以前の回答を指定する

エージェント環境に reflect skill をインストールし、レビューしたい対象の出力を渡して呼び出します。リポジトリのインストール例は npx skills add NeoLabHQ/context-engineering-kit --skill reflect です。より良い結果を得るには、元のプロンプト、ドラフト回答、受け入れ基準も含めてください。

入力の形を適切に整える

reflect は、タスク、重要度、そしてどの程度の確信度を求めるかが明示された入力で最もよく機能します。強いプロンプトの例は「このデプロイノートの正確性と見落としリスクを reflect してください。90% 未満の確信なら deep reflect で」といった形です。弱いプロンプトは単に「チェックして」です。合否の基準が具体的であるほど、レビューの価値は高まります。

まず読むべきファイル

まずは SKILL.md を確認してください。スキルの振る舞いを決める中核ルール、アイデンティティ、切り分けロジックが入っています。大きめの kit に組み込んで使うなら、README.md、AGENTS.md、およびリポジトリ全体のポリシーファイルも見て、reflection の段階を実際のワークフローに合わせてください。このリポジトリでは SKILL.md が主な正本です。

レビューゲートとして使う

実用的な reflect usage の流れは、ドラフトを作成し、reflect を実行し、レビューがリスクありと指摘した部分だけを修正する、というものです。元の出力が使い物にならない場合を除き、最初から全部を書き直させる必要はありません。reflect guide としての最適な使い方は、かなり絞られています。主張の検証、抜けている制約の洗い出し、そしてこのドラフトを安全に出してよいかの判断に使ってください。

reflect skill の FAQ

reflect は一般的なライティング用プロンプトですか？

いいえ。reflect は最初の下書きを作るためではなく、既にある案を評価するためのものです。通常の生成プロンプトとして使うと、reflect skill の最大の利点である、事後の дисциплинированное な精査が失われます。

reflect が向かないのはどんなときですか？

評価すべき事前回答がない場合、タスクが純粋に創造的な場合、あるいは拒否判断より広い発想出しが必要な場合には、あまり向いていません。正確性や完全性を判断するための文脈を十分に渡せない場合も、効果は下がります。

reflect は初心者向けですか？

はい。下書きと目的を渡せるなら使えます。リポジトリ全体を把握している必要はありませんが、「良い」の定義は伝える必要があります。初心者にとっての最大の利点は、reflect for Skill Validation を呼ぶ前にレビュー基準を明示できることです。

通常のプロンプトと比べると何が違いますか？

通常のプロンプトは、たいてい解決策を求めます。reflect は、その解決策を不確実性の下で批評するよう求め、穴や過信への注意をより強く向けます。そのため、最初の案づくりよりも、QA、受け入れ確認、重要度の高い出力に向いています。

reflect skill を改善する方法

与える証拠をもっと絞り込む

reflect の結果が最も強くなるのは、具体的な入力を渡したときです。元のタスク、ドラフト回答、そして最も懸念している失敗パターンを含めてください。技術系の作業なら、制約、エッジケース、対象読者も入れます。ポリシー文書や編集系の作業なら、満たすべきルールを明示してください。

適切な深さを指定する

スキルの confidence trigger は意図的に使ってください。ドラフトが単純なら quick check を、曖昧または高リスクなら deep reflection と明確な rejection criteria を求めます。これにより、reflect が簡単なケースを考えすぎたり、危険なケースを十分に見なかったりするのを防げます。

よくある失敗パターンに注意する

よくある問題は、曖昧な承認、根拠の薄い批判、そして実際の制約に照らした検証不足です。reflect skill の出力を改善するには、具体的な問題箇所を引用させ、その重要性を説明させたうえで、ドラフトをそのまま通すのか、修正するのか、却下するのかを明示させてください。

最初のレビュー後に反復する

最初の reflection は最終判断ではなく、切り分けの一回目だと考えてください。ドラフトを修正し、更新版に対して再度 reflect を実行して、修正で本当に抜けが埋まったかを確認します。ここでこのスキルの価値が出ます。誤承認は減り、やり直し箇所は明確になり、最終ゲートはより強固になります。