mcpField
T
template-design

template-design

github.com/owl-listenerエージェントワークフロー191298 回インストール20 週間前に更新
リポジトリ

template-design について

固定指示、変数、条件付きセクション、デフォルト値を組み合わせた再利用可能なプロンプトテンプレートを設計するスキルです。変数仕様や構成、品質基準、文書化とテストも扱います。

主な機能

  1. 01再利用可能なプロンプト構造
  2. 02型と範囲を定めた変数
  3. 03条件付きセクションとデフォルト値
  4. 04タスク・ペルソナ・形式・エスカレーションのパターン
  5. 05組み合わせ可能なテンプレート層
  6. 06文書化とテスト用成果物

活用シーン

  1. 01反復タスクのプロンプトを標準化
  2. 02基本指示にタスク固有のコンテキストを組み合わせ
  3. 03プロンプトテンプレート集のテストと保守

インストール

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

$npx skills add https://github.com/owl-listener/ai-design-skills --skill template-design

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

詳細

テンプレート設計

プロンプトテンプレートとは、実行時に変数スロットへ値を埋め込んで再利用できるプロンプトの構造です。テンプレートを使うと、類似タスク間の一貫性が保たれ、プロンプト管理を拡張しやすくなります。

テンプレートの構成要素

テンプレートは次の要素で構成されます。

  • 固定テキスト:毎回変わらない部分(指示、形式、役割)
  • 変数:特定の内容を埋め込むスロット(ユーザー入力、取得データ、設定)
  • 条件付きセクション:状況に応じて表示または非表示になる部分
  • デフォルト値:特定の値が指定されていない場合に変数へ設定する値

変数の設計

各変数には次の要件を満たす必要があります。

  • 明確な名前を付ける:{input1} ではなく {user_query} のようにします
  • 型を定義する:自由記述、選択肢からの選択、数値、真偽値のどれですか?
  • 範囲を定める:有効な値は何ですか?最大文字数はいくつですか?
  • 説明を付ける:この変数は何に使いますか?値はどこから取得しますか?
  • デフォルト値を設定する:値が未指定の場合、どうなりますか?

テンプレートのパターン

  • タスクテンプレート:特定の種類のタスク向けのテンプレートです。タスク固有の詳細を変数で指定し、指示は一定に保ちます。
  • ペルソナテンプレート:タスクの構成を固定し、ペルソナを変数にするテンプレートです。複数のペルソナを扱うプロダクトに役立ちます。
  • 形式テンプレート:分析方法を固定し、出力形式を変数にするテンプレートです。
  • エスカレーションテンプレート:複雑さのレベルが高くなると有効になるセクションを追加した、ベーステンプレートです。

テンプレートの組み合わせ

複雑なプロンプトは、小さなテンプレートを組み合わせて作成できます。

  • ベーステンプレート:すべてに適用される中核的な指示
  • タスクオーバーレイ:タスク固有の指示を重ねて適用します
  • コンテキストの挿入:取得した情報を特定の位置に挿入します
  • ユーザー設定:動作を変更する個人設定

テンプレートの品質基準

  • 一貫性:類似した入力に対して、安定して類似した出力を生成します
  • 柔軟性:多様なユースケースに対応できるだけの変化を変数で許容します
  • 明確さ:読みやすく、保守や変更が容易です
  • テスト可能性:標準的なテスト入力セットを使って、テンプレートが機能することを検証できます
  • 保守性:ある部分への変更が、ほかの部分を壊しません

設計成果物

  • ドキュメント付きのテンプレートライブラリ
  • テンプレートごとの変数仕様
  • テンプレートごとのテスト入力セット
  • テンプレートのバージョン管理と変更履歴
  • テンプレートを組み合わせるためのルール

コメント