タスク間でテンプレートを再利用する

場当たり的なプロンプトからプロンプトライブラリへ

ファイル構成: フラット構成

ファイル構成: カテゴリ別構成

命名規則

テンプレートのバージョン管理

テンプレートのドキュメントヘッダー

# Template: email_cold_outreach.j2
# Version: 2.1
# Author: Sarah Chen
# Created: 2025-03-15
# Last modified: 2025-05-10
# Changes in v2.1: Added 'value_prop' variable, removed generic opener
#
# Purpose:
#   Generate personalized cold outreach emails for B2B sales.
#
# Required variables:
#   - sender_name: str — Name of the sender
#   - recipient_name: str — First name of the recipient
#   - company_name: str — Recipient's company
#   - value_prop: str — 1-2 sentence value proposition tailored to this prospect
#   - cta: str — Specific call to action (e.g., '15-minute discovery call')
#
# Optional variables:
#   - tone: str (default: 'professional but warm')
#   - word_count: int (default: 120)
#
# Example output: see examples/email_cold_outreach_sample.txt
# Known limitations: Performs best when value_prop is specific to the company.

テンプレートレジストリ

# prompts/registry.py
# Central index of all prompt templates

TEMPLATE_REGISTRY = {
    'email_cold_outreach': {
        'file': 'marketing/email_cold_outreach.j2',
        'description': 'Cold outreach email for B2B prospecting',
        'required_vars': ['sender_name', 'recipient_name', 'company_name', 'value_prop', 'cta'],
        'optional_vars': {'tone': 'professional but warm', 'word_count': 120},
        'version': '2.1',
        'owner': 'sarah.chen'
    },
    'linkedin_post': {
        'file': 'marketing/linkedin_post.j2',
        'description': 'LinkedIn announcement post with professional tone',
        'required_vars': ['company', 'announcement', 'cta'],
        'optional_vars': {'tone': 'professional and approachable', 'word_count': 180},
        'version': '1.0',
        'owner': 'marketing_team'
    }
}

def get_template_info(name):
    return TEMPLATE_REGISTRY.get(name, None)

タスクをまたいだテンプレートの再利用

テンプレートの構成：ベース＋子テンプレート

# prompts/base_content.j2 — shared structure for all content templates
'''
You are a professional writer for {{company}}.

Style rules (apply to all outputs):
- Active voice
- No jargon unless defined
- Sentences under 25 words
- No passive voice
- Warm, direct tone

{% block task %}{% endblock %}

{% block constraints %}
Length: {{word_count | default(200)}} words.
{% endblock %}
'''

# prompts/blog_post.j2 — inherits base, adds blog-specific instructions
'''
{% extends 'base_content.j2' %}

{% block task %}
Write a blog post about {{topic}} for {{audience}}.
Structure: Hook (1 para) + Problem (1-2 para) + Solution (2-3 para) + Takeaway (1 para).
Include one concrete example.
{% endblock %}

{% block constraints %}
{{ super() }}
Do not mention competitors. Include one pull quote.
{% endblock %}
'''

テンプレートの性能を追跡する

import json
import datetime

def log_generation(template_name, template_version, variables, output, rating=None):
    log_entry = {
        'timestamp': datetime.datetime.utcnow().isoformat(),
        'template': template_name,
        'version': template_version,
        'input_vars': {k: str(v)[:50] for k, v in variables.items()},  # truncate for log
        'output_length': len(output),
        'rating': rating  # optional human rating 1-5
    }

    with open('logs/generation_log.jsonl', 'a') as f:
        f.write(json.dumps(log_entry) + '\n')

# Usage after generation
log_generation(
    template_name='email_cold_outreach',
    template_version='2.1',
    variables={'sender_name': 'Alice', 'company_name': 'Acme'},
    output='Dear Mr. Smith...',
    rating=4
)

テンプレートを廃止するタイミング

理解度チェック：プロンプトライブラリ

振り返り：タスクをまたいだテンプレートの再利用