mcpField
P
prompt-enhancer

prompt-enhancer

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

prompt-enhancer について

prompt-enhancer は、専門知識のない人の依頼を、分野に即した明確な表現に書き換えるスキルです。元の意図を保ちつつ、適切な用語や制約、背景、成功基準を盛り込みます。

主な機能

  1. 01依頼の本来の意図を明確化
  2. 02関連する背景と制約の追加
  3. 03適切な専門用語の使用
  4. 04重要な曖昧さの指摘
  5. 05タスクに応じた詳しさの調整

活用シーン

  1. 01曖昧な技術依頼の具体化
  2. 02コーディングタスクの制約明示
  3. 03専門家レビュー依頼の整理
  4. 04意図を変えずにプロンプトを改善

インストール

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

$npx skills add https://github.com/sammcj/agentic-coding --skill prompt-enhancer

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

詳細

エキスパート向けプロンプト拡張

専門家ではない人が書いたプロンプトを、同じ依頼をする際にその分野の専門家が使うような形式に変換します。 専門分野の用語や問題の構造化を学ばなくても、専門家の視点で整理された依頼のメリットを得られるようにすることが目的です。

エキスパートのコミュニケーションパターン

エキスパートの依頼は、初心者の依頼と比べて、次のような予測可能な違いがあります。

パターン初心者エキスパート
精度「もっと速くして」「ページの読み込みパフォーマンスを最適化して」
分解曖昧な依頼が1つだけ論理的な要素に分解されている
制約明示されていない制限、トレードオフ、成功基準が明示されている
コンテキスト不足しているシステムとの適合性、標準、過去の試行が示されている
失敗モード考慮されていない予測され、明示されている

役割の設定(例:「データベースアーキテクトとして、このスキーマをレビューしてください」)は、必須のパターンではなく、任意で使えるトーンの調整要素です。特定の専門的視点によって依頼が明確になる場合にのみ適用してください。

例

次の例は、初心者向けの依頼をエキスパート向けの形式に変換する方法を示しています。


元の依頼:「背中が痛いのですが、どうすればいいですか?」

エキスパート向けの書き換え:「背中の痛みへの対処法についてアドバイスしてください。次の点を扱ってください。背中の痛みについて、専門家による診察が必要かセルフケアでよいかを判断する方法、緊急の対応が必要な危険な症状、一般的な筋骨格系の背中の痛みに対するエビデンスに基づくセルフケアの方法、回復に役立つ活動の調整と避けるべき活動、異なる種類の専門家(一般開業医、理学療法士、カイロプラクターなど)への相談を検討すべきタイミングです。診断ではなく、十分な情報に基づいて判断できるよう支援することに重点を置いてください。」

変更点:「どうすればいいか教えて」から「この状況での意思決定について理解できるよう支援して」へと依頼を再構成しました。実際に役立つ情報の分類を指定し、適切な対応範囲の限界を明示しました。


元の依頼:「短編小説を書いてください」

エキスパート向けの書き換え:「約2,000語の短編小説を書いてください。上質な文芸誌に掲載されるような、内省的なトーンの純文学を目指してください。人物や人間関係についてのより大きな何かを明らかにする、小さく具体的な瞬間に焦点を当ててください。筋書きの仕組みよりも、語り口と内面描写を優先してください。結末は解決ではなく、余韻を残すものにしてください。設定で驚かせてください。」

**変更点:**長さ、ジャンルの方向性、トーンを指定しました。語り口、内面描写、余韻といった創作上の優先事項を明示しました。題材については創作の自由を残しながら、明確な美的方向性を示しています。


元の依頼:「データを整理するPythonスクリプトが必要です」

エキスパート向けの書き換え:「データをクリーニングするためのPythonスクリプトの作成を手伝ってください。データのサンプルを共有しますので、そこから存在するデータ品質の問題(欠損値、重複、不統一な形式、外れ値、エンコーディングの問題)を特定し、それぞれに対応するクリーニングコードを書いてください。pandasを使用してください。クリーニングが正しく行われたことを確認する検証も含めてください。各クリーニング手順を個別に分けてコメントを付け、特定のニーズに合わせて簡単に変更できるようにコードを構成してください。」

**変更点:**ワークフロー(サンプルの提示 → 問題の特定 → コードの作成)を確立しました。ツールを指定し、検証とモジュール形式の構成を求めています。このバージョンなら、ユーザー自身がデータの問題を事前に診断しなくても、データが共有された後に作業を進められます。


変換のアプローチ

プロンプトを書き換える際は、次の手順に従います。

  1. 分野と、この依頼を専門的に扱う人を特定します。 これにより、適用すべき用語、標準、考え方がわかります。

  2. 曖昧な表現の奥にある中心的な意図を見つけます。 ユーザーが実際に何を達成、または理解したいのかを確認します。

  3. 暗黙の要素や曖昧な点を特定します。 結果に影響するにもかかわらず、ユーザーが指定していないことは何でしょうか。次のように区別します。

    • 妥当なデフォルトを設定して補える不足(そのように対応します)
    • 推測を誤ると大きな問題につながる、真の曖昧さ(明示します)
  4. 専門家が用いる手法で再構成します。 正確な用語、適切な分解、明示的な制約、成功基準を用い、役割の設定が有効な場合はそれも加えます。

  5. タスクに応じて複雑さを調整します。 簡単な質問には、博士論文のような複雑さではなく、専門家らしい明確さが必要です。必要以上に複雑にしないでください。

制約

  • 意図を絶対に変えないでください。 高めるのは質問の仕方であり、質問の内容ではありません。
  • 要件を作り出さないでください。 明らかな不足は妥当なデフォルトで補い、ユーザーが示唆していないことは追加しないでください。
  • ユーザーにすべてを指定させるのではなく、妥当な仮定を置いてください。 目的は、ユーザーの負担を増やさずにプロンプトを改善することです。推測を誤ると大幅に結果が悪くなる場合に限り、曖昧さを明示してください。
  • 印象的な用語ではなく、正確な用語を使ってください。 分野固有の言葉は、明確にするために使い、難解にしたり威圧したりしないでください。
  • 出力形式にこだわりすぎないでください。 単純な変換には、率直な書き換えで十分です。変換にわかりにくい判断が含まれる場合に限り、説明を追加してください。

出力

専門家の視点で書き換えた内容を提示してください。曖昧な要素について仮定を置いた場合や、別の表現が有意義な選択肢となる場合は、書き換えの後に簡潔に記してください。

コメント