テンプレート駆動プロンプトエンジニアリング — 非エンジニアでも高品質なAI出力を得るスキーマ設計

export interface Template {
  id: string;
  name: string;
  description: string;
  instruction: string;
  parameters: Record<string, TemplateParameter>;
  webSearch: boolean;
  type?: "simple" | "workflow" | "api_chain" | "custom";
  processors?: ProcessorDefinition[];
  metadata?: TemplateMetadata;
}

export interface TemplateParameter {
  type: string;
  description: string;
  required: boolean;
}

export interface TemplateMetadata {
  complexity: "simple" | "medium" | "complex";
  estimatedTime?: number;
  tags?: string[];
  category?: string;
  version?: string;
  author?: string;
}

instruction（システムプロンプト）  ← プロンプトエンジニアが設計
parameters（ユーザー入力フィールド）← エンドユーザーが入力

{
  "id": "message_improver",
  "name": "Message & Mail Improver",
  "description": "Improve and polish your messages or emails for better clarity, tone, and effectiveness.",
  "instruction": "You are a professional communication specialist who improves messages and emails. Your task is to:\n\n1. **Content Enhancement**: Improve the clarity, tone, and effectiveness of the input message\n2. **Type-Specific Optimization**: \n   - **Email**: Use appropriate email structure, subject consideration, professional tone\n   - **SMS**: Keep concise, direct, and mobile-friendly while maintaining clarity\n3. **Politeness Level**: Adjust the message according to the specified politeness level:\n   - **Casual (1-2)**: Friendly, informal tone with casual expressions\n   - **Standard (3-4)**: Polite, everyday professional language\n   - **Formal (5-6)**: Business-appropriate formality and structure\n   - **Very Formal (7-8)**: Highly professional, respectful language\n   - **Ultra Formal (9-10)**: Most formal, ceremonial level of respect\n...\n\n## Output Format:\nProvide ONLY the improved (and optionally translated) message. Do not include any explanations, notes, headers, or additional formatting.",
  "parameters": {
    "message": {
      "type": "string",
      "description": "Enter the message or email content you want to improve",
      "required": true
    },
    "type": {
      "type": "string",
      "description": "Select message type: 'email' for email messages, 'sms' for SMS/text messages",
      "required": true
    },
    "politeness": {
      "type": "number",
      "description": "Set politeness level (1-10)",
      "required": true
    },
    "translate to": {
      "type": "string",
      "description": "Optional: Target language for translation (e.g. Japanese, English)",
      "required": false
    }
  },
  "webSearch": false
}

webSearch: boolean;  // テンプレートごとに固定

export interface TemplateParameter {
  type: string;       // "string" | "number" など
  description: string; // UIに表示する説明文
  required: boolean;   // 必須かどうか
}

let prompt = "# input\n";

Object.entries(parameterValues).forEach(([key, value]) => {
  prompt += `${key}: ${value}\n`;
});

# input
message: Dear team, I want to tell you about the meeting tomorrow.
type: email
politeness: 7
translate to: Japanese

const missingRequired = Object.entries(selectedTemplate.parameters)
  .filter(([key, param]) => param.required && !parameterValues[key])
  .map(([key]) => key);

if (missingRequired.length > 0) {
  error = m.please_fill_required({ fields: missingRequired.join(', ') });
  return;
}

type?: "simple" | "workflow" | "api_chain" | "custom";

export interface ProcessorDefinition {
  type: "ai_call" | "validation" | "transformation" | "api_call" | "formatting";
  id: string;
  name: string;
  config: ProcessorConfig;
  dependencies?: string[];  // 依存する前段のprocessor ID
}

// ProcessorConfigは処理タイプごとに異なる設定を持つ
export type ProcessorConfig = Record<string, unknown>;

{
  "type": "api_chain",
  "processors": [
    {
      "type": "api_call",
      "id": "fetch_data",
      "name": "外部データ取得",
      "config": {
        "endpoint": "/api/lookup",
        "method": "GET"
      }
    },
    {
      "type": "ai_call",
      "id": "analyze",
      "name": "データ分析",
      "config": {
        "instruction": "取得したデータを分析して要約してください"
      },
      "dependencies": ["fetch_data"]
    }
  ]
}

src/lib/templates/
├── en/
│   ├── message_improver.json
│   ├── zipcode_extractor.json
│   └── omikuji_fortune.json
└── ja/
    ├── message_improver.json
    ├── zipcode_extractor.json
    └── omikuji_fortune.json

export interface TemplateMetadata {
  complexity: "simple" | "medium" | "complex";
  estimatedTime?: number;
  tags?: string[];
  category?: string;
}