reflect

reflect skill の概要

reflect ができること

reflect は、Claude との会話の途中で立ち止まって見直すための reflect skill です。実行をいったん止め、当初のゴールから会話を読み返し、進むべき方向について率直に判断します。細部へさらに入り込むのではなく、いまの進め方がまだ妥当か、どんな前提に引っ張られているか、何が抜けている可能性があるか、次に取るべき行動が「続行」「方向転換」「一時停止」のどれかを確認します。

Decision Support、計画づくり、プロダクト開発、デバッグの堂々巡り、戦略議論、そして戦術的には前進しているように見えても戦略的にはズレ始めている可能性がある長いやり取りで特に役立ちます。

向いているユーザーと場面

AI アシスタントに複数ステップの作業をよく手伝わせていて、信頼できる「いったん冷静に確認する」仕組みがほしいなら、reflect のインストールが向いています。「少し引いて見て」「何か見落としていない？」「考えすぎていない？」「全体を見直して」「まだ本筋に沿っている？」といった依頼をよくするユーザーに合います。

最も強い用途は要約ではありません。本来の役割は、方向修正です。会話が誤った方向に固まる前に、確証バイアス、サンクコスト思考、アンカリング、複雑化の進行、直近情報への偏りを見つけることにあります。

reflect の違い

このスキルは、あえて入力要求を少なく設計されています。これまでの会話に十分な文脈があれば、長い事前説明を求めずすぐに実行されるべきです。文脈が薄すぎる場合も、振り返りを別の計画作業に変えてしまうのではなく、判断に必要な確認質問を 1 つだけ投げます。

付属の参照資料は、実務上の規律を加えてくれます。振り返りでは当初のゴールから読み返すこと、厳密に見せるためだけに問題をでっち上げないこと、最後は具体的な推奨に落とすことが求められます。含まれている scripts も、チームで transcript をテストしたり、振り返りの出力が十分に具体的か検証したりしたい場合に便利です。

reflect skill の使い方

reflect のインストールとリポジトリパス

GitHub repository から次のコマンドでスキルをインストールします。

npx skills add alirezarezvani/claude-skills --skill reflect

ソースは次の場所にあります。

productivity/reflect/skills/reflect

まず SKILL.md を読み、そのうえで動作モデルを理解するために次のファイルを確認してください。

• references/cognitive_bias_canon.md
• references/conversation_reflection_practice.md
• references/honest_output_discipline.md
• scripts/bias_pattern_detector.py
• scripts/conversation_depth_analyzer.py
• scripts/directional_recommendation_validator.py

これは純粋な推論スキルです。対応する skill environment 以外に、外部 API、データベース、特定ベンダーのツールは必要ありません。

実務で reflect を呼び出す方法

進行中の会話の中で、直接的な言い方で依頼します。

• “Reflect on where we are before we continue.”
• “Take a step back. Are we solving the right problem?”
• “Sanity check this plan for bias and drift.”
• “Are we overthinking this, or is the complexity justified?”
• “Use reflect for Decision Support: should we continue, pivot, or pause?”

良い reflect の依頼には、単なるトピックではなく「いま何を決めようとしているのか」という意思決定上の圧力が含まれます。たとえば “reflect on this” ではなく、次のように書くと効果的です。“Reflect before we implement. Original goal: reduce onboarding friction. Current path: adding a multi-step configuration wizard. Check whether this is still aligned, what assumptions we are making, and whether we should continue, pivot, or pause.”

出力品質を高める入力

このスキルは、会話の中に当初のゴール、現在の計画、制約、直近の意思決定がすでに含まれていると最もよく機能します。それらが会話内に散らばっている場合は、reflect を呼び出す前に短く整理して書き直すとよいでしょう。

有用な入力パターンは次のとおりです。

• Original goal: 何をもって成功とするはずだったか
• Current direction: いま会話が何を最適化しようとしているか
• Decision point: これから何にコミットしようとしているか
• Constraints: 期限、許容できるリスク、ユーザーニーズ、技術的制約
• Concern: 方向のズレ、複雑化、バイアス、証拠不足、行き詰まり

これにより、スキルは直近数ターンに反応するだけでなく、現在の進め方を最初の枠組みと比較できます。

script を使った任意のワークフロー

scripts は必須ではありませんが、再現性のあるレビューには役立ちます。transcript を User: と Assistant: のターンを含むプレーンテキストとして保存し、次を実行します。

python scripts/conversation_depth_analyzer.py --conversation /tmp/transcript.txt

bias_pattern_detector.py は、候補となるバイアスパターンを見つけるために使います。ただし、regex の一致を証拠として扱うのではなく、AI に判断を適用させてください。振り返りを生成したあと、directional_recommendation_validator.py を使うと、出力が具体的な continue、pivot、pause の推奨で終わっているか、曖昧な安心材料に逃げていないかを確認できます。

reflect skill FAQ

reflect は、より良い要約プロンプトですか？

いいえ。要約は起きたことを圧縮します。一方で reflect は、会話がまだ正しい成果に向かっているかを判断します。reflect skill は、方向のズレ、不足している証拠、作り込みすぎた解決策、見落とされた制約、根拠の薄い勢いを表面化するべきです。もし本当に問題がないなら、反論を無理に作るのではなく、根拠とともにその旨を示すべきです。

reflect を使わないほうがよい場面は？

単純な一回限りの作業、事実確認、または再評価するだけの意味ある過去文脈がない場面には向きません。励ましだけがほしい場合や、文体フィードバックだけが目的の場合にも適していません。このスキルは進行中の勢いに割り込むために設計されており、複雑な作業では価値がありますが、些細なタスクには不要です。

reflect は初心者にも使いやすいですか？

はい。呼び出しは “reflect” や “take a step back” のように簡単でかまいません。初心者は入力要求の少ない設計から恩恵を受けられますし、上級者は当初のゴール、現在の意思決定、疑っている失敗パターンを渡すことで、より良い結果を得られます。

Decision Support における reflect はチームにどう役立ちますか？

Decision Support での reflect は、コミットする前に構造化された一時停止を提供します。プロダクトの方向性を選ぶ前、技術設計を確定する前、デバッグ方針を続ける前、提案を受け入れる前に有効です。誤った方向へ進み続けるコストが、再評価のために立ち止まるコストより高いときに、特に価値が大きくなります。

reflect skill を改善する方法

reflect に明確な意思決定の焦点を与える

弱い出力で最も多い原因は、呼び出しが曖昧なことです。“Reflect on our discussion” でも機能する場合はありますが、“Reflect before we choose option B; check for anchoring, missing counterevidence, and whether we should continue, pivot, or pause” と書けば、スキルにより鋭い判断対象を与えられます。

特に気にしているリスクがあるなら、それを明示してください。例: “I’m worried we are adding features because each one sounds reasonable individually. Check for complexity bias.”

証拠に基づく再評価を促す

良い reflect の出力は、会話中の具体的な根拠を引用するべきです。当初のゴール、議論の枠組みが変わった地点、支配的になった前提、検証が必要な意思決定などです。返答が一般論に感じられる場合は、次のように依頼してください。“Redo the reflection using specific evidence from earlier turns and end with a concrete recommendation.”

これは repository の honest-output discipline と一致します。曖昧な悲観も、曖昧な安心材料も、でっち上げの問題も避けるという考え方です。

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

reflect でよくある失敗には、直近のターンだけに注目する、判断ではなく要約に終わる、証拠なしに問題を見つける、明確な次の行動なしに終わる、といったものがあります。もう 1 つの失敗は質問しすぎることです。このスキルが確認質問をするべきなのは、再評価するには会話の文脈が薄すぎる場合に限られます。

こうした場合は、次のように修正できます。“Reread from the original goal, not just the recent implementation details. Identify the strongest reason to continue and the strongest reason to pivot.”

最初の推奨のあとで反復する

最初の振り返りは作業の終点ではなく、意思決定のチェックポイントとして扱ってください。推奨が “continue” なら、その見方を変える証拠は何かを尋ねます。“pivot” なら、最小限で成立する方向転換を尋ねます。“pause” なら、続行前に解消すべき不足情報を具体的に確認します。

こうすることで reflect は実務的に機能します。目的は分析を増やすことではなく、次の行動をより良くすることです。