agently-prompt-management

Agently プロンプト管理

このスキルは、1 つのリクエストまたはリクエストファミリーを実行する前に、プロンプトの状態をどのように構造化すべきかが中心的な課題である場合に使用します。

ネイティブ優先のルール

• 連結されたプロンプト文字列よりも、input(...)、instruct(...)、info(...)、output(...) を優先してください
• 再利用可能なプロンプト構造は、その場限りのリテラルではなく、プロンプト設定または YAML に移してください
• 実行時変数はプロンプトファイル内で ${...} プレースホルダーとして保持し、ロード時にマッピングを通じて注入してください
• タスク固有のリクエスト契約はプロンプト設定に保持し、広く再利用されるペルソナ設定のみをコード側の小さなファクトリーに保持してください
• 出力契約が安定しており、リクエストファミリー間で共有される場合は、Python でその場限りに再構築するのではなく、.request.output などのプロンプト設定に保持してください
• プロンプトの構成は、トランスポートおよびオーケストレーションから分離してください
• UI チームやプロダクトチームがワークフローコードを書き直すことなくプロンプト駆動の動作を調整する必要がある場合は、設定ファイルを編集可能なブリッジとして使用してください

アンチパターン

• タスクが些細なものでない限り、ビジネスコンテキストを 1 つの不透明な文字列に平坦化しないでください
• プロンプトマッピングがすでに適合している場合は、その場限りの .format(...) や文字列連結でプロンプトテンプレートを再構築しないでください
• 1 つのプロンプト設定が所有できる安定したプロンプト契約や出力契約を、複数の Python ヘルパーに散在させないでください
• プロンプト設定ファイルをワークフロー状態の代替として使用しないでください

次に読む

• references/overview.md