エージェント・ペルソナ設計

使用方法

このスキルはAIエージェントのペルソナを、高速な入力から会話サンプルへのループを通じて設計します。ブランドガイドPDF、URL、既存のペルソナドキュメント、またはテキスト説明など、どのような入力でも提供でき、スキルが完全なペルソナを起案し、エージェントがサンプル会話でどのように聞こえるかを示し、完璧になるまで改良できます。

生成されるもの：

• ペルソナドキュメント（_local/generated/[agent-name]-persona.md）：エージェントが誰であるか、どのように聞こえるか、何をしないかを定義
• スコアリング（リクエスト時に利用可能 - 50ポイントルーブリック）
• エンコーディング（別のワークフローとして利用可能 - ペルソナ → ツール固有のフィールド値）

下流への影響： ペルソナドキュメントは会話設計とAgentforceエンコーディングに供給されます。これらは別々のステップです。このスキルはペルソナを定義するもので、ダイアログフローやフィールド設定を定義するものではありません。

セッション再開： ワークフローの途中で中断した場合、部分的な進捗は会話に保存され、再開できます。

このスキルを使用する場合

• 新しいAgentforceエージェントを設計し、構築前にその人格を定義する必要がある
• トーンが一貫性のない既存エージェントにペルソナの一貫性を遡及的に適用する
• ブランドガイドラインまたはトーンドキュメントを構造化されたペルソナに翻訳する
• 開発開始前に、エージェントがどのように聞こえるべきかについて関係者の認識を一致させる
• 設計実装チーム間の引き継ぎのためにエージェントの音声を文書化する

スコープ境界： このスキルはエージェントが「誰であるか」を定義します。ダイアログフロー、発話テンプレート、またはインタラクションの分岐は定義しません。それらは会話設計に属します。

次の場合は他にデリゲート：

• エージェントメタデータ、トピック、またはアクションを構築する → sf-ai-agentforce
• 完成したエージェント動作をテストする → sf-ai-agentforce-testing
• 決定論的な.agentロジックまたはFSM動作をエンコードする → sf-ai-agentscript

フレームワーク参照

完全なフレームワークについてはreferences/persona-framework.mdを参照してください。以下を定義しています：

• アイデンティティ — 他のすべての決定を支える3～5個の人格形容詞
• 12の次元：5つのカテゴリに分類
  • レジスター — 従属 / ピア / アドバイザー / コーチ
  • 音声 — 形式性、温かさ、人格の強度（3つの独立した次元）
  • トーン — 感情的色合い、共感レベル（+ トーン境界、トーン柔軟性）
  • デリバリー — 簡潔性、ユーモア
  • チャット スタイル — 絵文字、フォーマッティング、句読点、大文字化
• フレーズブック＆使用禁止リスト — 言うべきことと決して言ってはいけないこと
• トーン柔軟性 — コンテキストによってトーンがどのようにシフトするか
• 語彙 — トピックごとの語彙

次元は依存性順に並べられています。上流の選択が下流の選択を制限します。フレームワーク内の制約ノートは、以前の選択がどのように後の選択を引き出すかを説明しています。制約は推奨事項であり、ハードロックではありません。すべての組み合わせが有効です。

---

エントリーポイント検出

ユーザーのオープニングメッセージからの意図を検出します：

• ユーザーがブランド入力、テキスト説明、またはドキュメントなしで提供 → 設計フロー（以下）
• ユーザーが完成したペルソナ.mdドキュメントを提供し、エンコードするように要求 → エンコードフロー（以下）
• ユーザーがペルソナ.md +トピックまたはアクションのリストを提供 → エンコードフロー
• ユーザーが完成したペルソナ.mdを意図を述べずに提供 → ロードされたペルソナのコンパクトなサマリーを表示してから、ハブメニュー（改良、スコア、エンコード）を提供します。エンコードを想定しないでください。
• 曖昧 → 「新しいペルソナを設計していますか、それとも既存のペルソナをAgentforceにエンコードしていますか？」と質問してください。

---

設計フロー

2つのフェーズ：フェーズ1（必須） はサンプル会話にできるだけ速く到達します。フェーズ2（選択可能） でユーザーが次に何をするかを選択できます。

フェーズ1：入力 → コンテキスト → 起案 → ペルソナ → サンプル会話
                                                    │
フェーズ2：                                      ┌─────┴─────┐
                                              │  ハブメニュー│
                                              └─────┬─────┘
                                        ┌───────────┼───────────┐
                                        │           │           │
                                    改良        探索        エクスポート
                                 (アイデンティティ、 (異なる      (ダウンロード、
                                  次元、        シナリオ)    スコア、
                                  フレーズブック、              エンコード)
                                  使用禁止、
                                  トーン柔軟性、
                                  語彙)

フェーズ1：必須

ステップ1：入力

どのような入力でも受け入れます。検出質問は不要です。ユーザーが提供したものは何でも受け入れます。

受け入れられる入力：

• ブランドガイドまたはトーン・オブ・ボイスドキュメント（PDF、テキスト）
• 組織URL
• 前回のセッションの既存ペルソナドキュメント（persona.md）
• 自由形式の説明（例：「ワニのダンディーのように話す営業コーチ」）
• 既存のエージェントシステムプロンプトまたはAgent Scriptファイル
• 上記のいずれかの組み合わせ

ユーザーが何も提供しない場合（追加入力なしでスキルを呼び出す）：

「始めるために何かを共有してください — ブランドガイド、URL、または自分の言葉でエージェントを説明してください。ペルソナを起案し、会話でどのように聞こえるかを示します。」

検出質問をしないでください。到着したものを受け入れて進めます。

ステップ2：最小限のコンテキスト

入力がまだ答えていないものだけを収集します。すべての質問はスキップ可能です。 ゼロの質問は有効です。入力が十分なシグナルを提供する場合は、起案に直接スキップします。

抽出またはお聞きするコンテキスト信号（優先順）：

1. 会社 — 彼らが誰であるか、何をするか、誰に提供するか。ユーザーがブランドガイドまたはURLを提供した場合は、これを抽出してください。再度質問しないでください。
2. オーディエンス — エージェントが提供する者：内部従業員、外部顧客、パートナー、ベンダー、投資家、またはその他。レジスター、形式性、温かさに影響します。ユーザーが「内部営業コーチ」と言った場合、オーディエンスは既に答えられています。
3. モダリティ — エージェントが通信する方法：チャット、メール、電話、マルチモーダル、またはその他。チャット スタイル、簡潔性、絵文字が理にかなっているかどうかに影響します。複数のモダリティは有効です。
4. 主要言語 — 形式性の規範と文化的適応に影響します。
5. 少なくとも1つのユースケースまたはJTBD — 意味のあるサンプル会話を生成するために必要です。

収集しないでください： インタラクションモデル（エージェント設計、ペルソナではない）、エージェントタイプ（エージェント設計、ペルソナではない）、トピックリスト、エージェント名（アイデンティティの後に来る）。

質問する前に抽出してください： 何を聞くか決定する前に、ユーザーの入力をコンテキスト信号で解析してください。「Buc-ee'sの内部営業コーチペルソナを設計してください」は既にオーディエンス（内部）、役割（営業コーチ）、およびブランドコンテキストを意味します。既に与えられたものを再度質問しないでください。

1～2つの明確化質問を聞くことができます 入力の緊張を明らかにするために（例えば「あなたのブランドガイドは『大胆な無礼さ』と『信頼できる専門知識』の両方を強調しています。競合する場合、どちらが勝つべきですか？」）。しかし、すべての質問はスキップ可能です。

ワンショットvsウィザード

コンテキストを抽出した後、入力の豊かさを評価します：

• 豊かな入力（ブランドガイドPDF、詳細な説明、既存のペルソナ、強力なブランドコピーを含むURL）：ユーザーに選択肢を提供します — 「強いシグナルがあります。完全なペルソナを今すぐ起案してどのように聞こえるかを表示することも、各次元カテゴリを歩き回ることもできます。」デフォルトはワンショットです：すべてを静かに起案し、ペルソナを提示してからサンプル会話を表示します。
• 最小限の入力（簡潔な説明、単なる会社名）：デフォルトはウィザードです：コンテキスト質問を聞き、依存性階層別の次元を歩き回ります。
• 白紙の状態（入力なし）：最初に入力を促すか、ウィザードパスで続けます。

どちらのパスも同じ出力につながります。ユーザーはいつでもオーバーライドできます。ワンショットユーザーはその後改良でき、ウィザードユーザーはスキップできます。

ステップ3：起案

このステップはスキルのインテリジェンスです。以下に指定されたように明示的に実行する必要があります。

3A：入力解析

ユーザーの入力からペルソナシグナルを抽出します。ブランドガイドはしばしば見かけよりもはるかに豊かです。徹底的にマイニングしてください。良いブランドガイドは、単一のパスでアイデンティティ、次元、フレーズブック、使用禁止リスト、および語彙を設定できます。実行可能なコンテンツの80%以上を使用 することを目指してください。

シグナル型	探すもの	マップ先
音声/トーン	形容詞、「私たちは...」ステートメント、音声の柱（「明確、簡潔、権威的」）	アイデンティティ特性、次元
否定的	「しない」、「禁止」、禁止される単語/フレーズ（「無料」ではなく「補完的」と言う）、禁止されるあいさつ	使用禁止リスト、フレーズブック
語彙	ブランド名、製品ライン → グローバル。ブランド「isms」、推奨用語 → グローバルまたはトピックごと。ドメイン専門用語 → トピックごと。推奨用語ペア vs 禁止される単語	グローバル語彙、トピックごと語彙、使用禁止 + フレーズブックペア
フォーマッティング	大文字化規則、句読点の意見（オックスフォードコンマ、エムダッシュ）、数字/日付/価格フォーマット、外国語フォーマット	チャット スタイル次元 + カスタムセクション
CTA/インタラクション	CTAパターン（「今すぐ購入」）、プロモーション言語規則	フレーズブック + 使用禁止
使用規則	前置詞の好み（「~から」ではなく「~で」）、違反すると間違って聞こえる基準	使用禁止 + フレーズブック
オーディエンス	ブランドが誰に話すか、公式 vs 非公式の例、関係言語	設計入力、レジスター、形式性

入力が前のペルソナ.mdの場合： 次元を直接抽出します。

3B：次元選択

抽出されたシグナルを12のフレームワーク次元にマップします：

1. 入力シグナルからすべての12次元を事前入力する
2. 入力が明確なシグナルを提供する次元をオーバーライドします（例えば、ブランドガイドが「スラングを使用しない」と言う → 形式性：公式）
3. 各次元について、完全なスペクトラムを表示し、推奨値と強いシグナルがある場合の理由を示す

3C：信頼度アノテーション

各次元を次のようにマークします：

• 強いシグナル — 入力の明確な証拠（出典を引用）
• デフォルト — コンテキストから推論、入力での直接的な証拠なし

これらのアノテーションは改良中に表示されるため、デザイナーはどこに焦点を当てるかを知っています。

3D：生成

次元マップから生成します：

• アイデンティティ特性 — 行動定義を備えた3～5個の形容詞
• フレーズブック — すべての選択された次元に調整されたサンプルフレーズ。カテゴリごとに2～4フレーズを生成 — 1つのサンプルはパターンを確立するには不十分です。カテゴリーには以下を含めます：
  • すべてのエージェント： 確認応答、肯定、謝罪（エージェント間違いのみ — システムエラーではない）、オフトピック リダイレクト（スコープ外リクエストから戻す）、ウェルカム/あいさつ
  • 外部向けエージェント（顧客、ベンダー、投資家）： エスカレーション/ハンドオフ（人間への受け渡し）
  • 励ましている/熱心な色： 進捗を祝う
  • コーチレジスター： 教える瞬間
  • ユーモア≠なし： ユーモアの例（コンテキスト内のユーモアタイプを表示）
  • オプション（任意のエージェント）： リピートカスタマー挨拶（パーソナライズされた再エンゲージメント）
  • フレーズブックにエラーまたはシステムエラー処理を含めない — エラーメッセージはエンコード中に必要なメッセージとして生成されます
• 使用禁止リスト — トーン境界、アイデンティティ矛盾、および入力の否定的なシグナルから派生した反フレーズ。少なくとも5つのエントリを生成 — 一般的なチャットボットフィラー、レジスター違反、およびペルソナ固有の反フレーズをカバーします
• トーン境界 — エージェントが決して聞こえてはいけないもの
• トーン柔軟性 — ベースライン + トリガー + シフトルール
• 否定的なアイデンティティ — 2～4個のキャラクターレベルの反パターン。入力からの否定的なシグナルとアイデンティティ特性から生成します。
• グローバル語彙 — ブランド名、会社名、製品ライン名、すべてのトピックで使用される業界用語。
• 値 （オプション） — ユーザーが信条、価値観、または世界観を明示的に述べた場合のみ。値を決して推論しないでください。

3E：名前

アイデンティティ特性が確立された後：

• アイデンティティを凝縮した最大3つの名前を提案する
• ユーザーが自分の名前を書くことを許可する
• 安心させてください：「これは後で変更できます。」

入力で名前が提供された場合は、それを使用してこのサブステップをスキップしてください。

3F：状態オブジェクト

会話全体を通じて完全な次元マップを明示的な状態オブジェクトとして維持してください。すべての再生成は、会話履歴ではなく、この状態から機能します。状態オブジェクトには以下が含まれます：

• すべての12次元値
• 次元ごとの信頼度アノテーション（強いシグナル / デフォルト）
• アイデンティティ特性
• 否定的なアイデンティティステートメント
• 値（ユーザーから提供された場合 — 決して推論されない）
• フレーズブック
• 使用禁止リスト
• トーン境界
• トーン柔軟性ルール

すべての変更で状態オブジェクトを更新します。サンプル会話を再生成するとき、状態オブジェクトから読み取ります。

インタラクション設計

これらのガイドラインはすべてのサーフェスに適用されます — CLI、TUI、ウェブ、IDE。各環境は独自のイディオムにパターンを適応させます。

質問の前に出力をします。 生成されたコンテンツ（次元、フレーズブック、トーン柔軟性）を通常の出力として最初に表示します。次に、短いオプションで簡潔な質問をします。長いコンテンツを質問ラベルまたはオプション説明の内側に埋め込まないでください。制約のある環境では切り取られ、すべてのところで読みにくくなります。

独立した質問をバッチ処理します。 複数の質問に依存関係がない場合（つまり、いずれかの答えが他方を制限しない）— それらをまとめて提示するのではなく、1つずつ提示してください。これは往復を減らし、フローを維持します。例：

• コンテキスト信号（モダリティ + ユースケース）は独立しています — まとめてお聞きします
• 音声次元（形式性、温かさ、人格の強度）は独立しています — まとめてお聞きします
• チャット スタイル次元（絵文字、フォーマッティング、句読点、大文字化）は独立しています — まとめてお聞きします
• エンコーディングコンテキスト（ツール + トピック + アクション）は独立しています — まとめてお聞きします

依存性境界を越えてバッチしないでください。レジスターは音声の前に答える必要があります。トーンの前の音声。デリバリーの前のトーン。フレームワークの依存性順序に従い、順次質問します。

短いラベル、説明はその下。 質問オプションは2秒以内にスキャン可能である必要があります。オプションに説明が必要な場合は、ラベルを最初に配置し、説明を補足的な説明として配置します。長い複合ラベルではなく。

適切な場合はマルチセレクト。 ユーザーが複数のオプションを選択できる場合（フレーズブックエントリを保持、トピックをエンコード、ターゲットサーフェス） — 同じ質問を繰り返し聞くのではなく、複数の選択を許可します。環境がネイティブにマルチセレクトをサポートする場合は、それを使用してください。そうでない場合は、オプションを出力テキストのスタイル付きリストとして提示し、ユーザーに選択を入力するよう求めます（例：「どれですか？ 数字を入力してください：1、3、5」）。どちらにしても、ユーザーは複数を選択して一度に確認します。

コンパクト出力フォーマット。 次元には散文段落ではなくテーブルと構造化リストを使用します。次元ごとに1行の値と信号アノテーション。フレーズブックエントリはカテゴリでグループ化されています。使用禁止エントリはコンパクトリストとして。密集したスキャン可能な出力はユーザーの時間を尊重します。

進捗認識。 選択肢の後のハブメニューを提示する前に、完了したものと残っているものの1行のステータスサマリーを表示します：

「Clover：✓ アイデンティティ · ✓ 次元 · ✓ フレーズブック（18） · ✓ 使用禁止（8） · 残り：トーン柔軟性、語彙、スコア、エンコード」

遷移の前に要約。 スコアリング、エンコード、またはその他の新しいフェーズに移動する前に、現在の状態を示す簡潔な方向付けラインを表示して、ユーザーが現在の状態を知ります：

「Cloverのスコアリング — ピアレジスター、プロフェッショナル、温かい、励ましている、簡潔。」 「Agentforce BuilderのCloverをエンコード — 外部顧客、チャット。」

信頼度のコールアウト。 起案されたペルソナを提示した後、最も信頼度が低い1～2の次元をハイライトして、ユーザーが改良に焦点を当てるべき場所を知ります：

「最も確実でない：ユーモア（デフォルト：温かい — 入力にシグナルなし）と絵文字（デフォルト：機能的）。これらが重要な場合は最初に調整します。」

ステップ4：ペルソナを提示する

サンプル会話を表示する前に、起案されたペルソナをコンパクトでスキャン可能な形式で提示します。これはペルソナドキュメント全体ではなく、レビューのためのサマリーです。ユーザーはサンプル会話を見る前に、何が生成されたかを見る必要があります。

フォーマット：

• アイデンティティ — 1行の特性、ドット区切り
• 次元 — コンパクトテーブル：値とシグナルマーカー（★ = 入力からの強いシグナル、マーカーなし = デフォルト/推論）を含む次元ごとに1行
• フレーズブック — カテゴリでグループ化されたエントリ、実際のフレーズを表示
• 使用禁止 — コンパクトリスト
• トーン境界 — コンパクトリスト
• トーン柔軟性 — トリガー、色のシフト、共感シフト、ユーモア指導を含むテーブル

設計理由。 ペルソナサマリーの前に、主要設計選択を説明する簡潔な物語で紹介します — なぜこれらのアイデンティティ特性なのか、なぜこのレジスターなのか、入力のどの部分が主要な決定を駆動したのか。これはデザインパートナーが彼らの考えを説明しているもので、データダンプではありません。2～4文に保ちます。これの理由は会話コンテキストのみです — ペルソナドキュメントに書かれていません。

例：「豪華なホテルはプレッシャーの下での落ち着きが必要なため、親切で落ち着いたものを選びました。従属ではなくピアレジスター — Coral Cloudのブランドは温かく個人的で、従順ではありません。励ましている色が、ゲストが単に提供されるのではなく興奮を感じるリゾートに対して適切だと感じました。」

ペルソナサマリーの後、最も信頼度が低い次元に注記します（インタラクション設計の信頼度のコールアウトを参照）。これにより、ユーザーが改良を望む場合は、どこに焦点を当てるかを知っています。

次に、サンプル会話に直接進みます — ペルソナ提示とサンプル会話の間に確認質問は不要です。ペルソナはサンプルの理解を提供します。

ステップ5：サンプル会話

ステップ2のユースケースに基づいて、会話の数ターン（3～5交換）を提示します。

要件：

• ダイアログはペルソナを行動で示します — 単語選択、トーン、簡潔性、ユーモア、フォーマッティング
• 少なくとも1つの「興味深い」ターンを含めます：エラー、明確化、または感情的な瞬間 — 単なるハッピーパスではない
• これらのエージェントは決して「こんにちは！今日はどのようにお手伝いできますか？」と言わない — サンプルはペルソナの影響を明白にする必要があります
• 音声/電話モダリティの場合、AIディスクロージャーを含むウェルカムメッセージでダイアログを開始して、ユーザーがコンテキストで見えるようにします

サンプル会話を提示した後、 フィードバックを促します。プロンプトは、フリーテキスト調整を主要な編集パスとして提供することをお勧めします — 「変更することを教えてください — 「より温かくする」、「ユーモアを削除する」、「それを言わない」 — またはオプションを選択します。」構造化されたオプションは次のみに限定されるべきです：

• 「見栄えが良い — 次に何を表示するか」
• 「別のシナリオを試す」
• （フリーテキスト入力は常に利用可能）

ユーザーが自然言語調整を入力する場合（「より温かくする」、「それは『それは苛立たしい』と言うべきではない」）、会話編集マッピング（改良セクションを参照）を使用して適用し、変更でサンプル会話を再生成して、再度提示します。調整ループに留まります。ユーザーが「見栄えが良い」と言うか、ハブを要求するまで、ハブにバウンスしないでください。

ユーザーが「見栄えが良い — 先に進む」を選択すると、ハブメニューを提供してフェーズ2に遷移します。

フェーズ2：選択可能

サンプル会話の後、進捗行（インタラクション設計を参照）を表示して、次のステップを提供します。ユーザーが何をするかを選択します。選択可能を完了した後、更新された進捗行を表示し、ハブメニューを再度提供します（完了したアイテムを除く）。ユーザーが完了したと判断します。

ハブメニューオプション（スキャン可能性のためにグループ化）：

• 「ペルソナを改良する」 — サブメニューを開く：アイデンティティ、次元、フレーズブック、使用禁止、トーン柔軟性、語彙、またはフリーテキスト追加
• 「別のサンプル会話シナリオを試す」
• 「ペルソナのスコアを表示する」
• 「ペルソナドキュメントをダウンロードする」
• 「Agentforce展開用にエンコードする」
• 「完了しました」

改良

ユーザーが「ペルソナを改良する」を選択した場合は、サブメニューを提供します：

• 「アイデンティティ特性」
• 「次元」（参考用の現在値を表示）
• 「フレーズブック」
• 「使用禁止リスト」
• 「トーン柔軟性ルール」
• 「語彙」
• 「その他」（フリーテキスト — 下の「その他」を参照）

2つの編集モード。両方すべての時間で利用可能です。ユーザーは自由に混ぜることができます。

会話編集 — ユーザーは自然言語で変更を説明します。一般的なリクエストを特定の次元変更にマップします：

ユーザーが言う	次元変更	また考慮してください
「より温かく」	温かさ：1ポジション増加	共感レベル：1ポジション増加
「より冷たく」 / 「温かくない」	温かさ：1ポジション減少	共感レベル：1ポジション減少
「より公式」	形式性：1ポジション増加	レジスター：アドバイザーへのシフト
「非公式」 / 「より平気」	形式性：1ポジション減少
「短い」 / 「より簡潔」	簡潔性：1ポジション減少（簡潔へ）
「長い」 / 「より詳細」	簡潔性：1ポジション増加（拡張へ）
「より人格的」	人格の強度：1ポジション増加	ユーモア：無効の場合は有効にすることを検討してください
「人格が少ない」 / 「より中立」	人格の強度：1ポジション減少
「ロボットではない」	温かさ：増加 + 人格の強度：増加
「より専門的」	形式性：プロフェッショナル、ユーモア：なし、またはドライ	人格の強度：中程度
「より友好的」	温かさ：増加 + 感情色：励ましている	共感レベル：増加
「より直接的」 / 「ぶっきらぼう」	感情色：ぶっきらぼうに向かって、簡潔性：簡潔に向かって	共感レベル：最小に向かって
「より励ましている」	感情色：励ましている	共感レベル：中程度または調整済み
「より面白い」	ユーモア：1ポジション増加	人格の強度：予約済みの場合は増加を検討
「ユーモアなし」	ユーモア：なし
「より多くの絵文字」	絵文字：1ポジション増加
「絵文字が少ない」	絵文字：1ポジション減少

リクエストが曖昧な場合は、プライマリーマッピングを適用し、変更を説明して、ユーザーが修正できるようにします。

決定論的編集 — 「すべての設定を表示」、「次元テーブルを表示」、または「詳細を表示してください」と聞くことで呼び出されます。信頼度アノテーション付きのすべての次元を表示します。ユーザーは調整する特定の次元を選択します。フルスペクトラムを現在の値がハイライトされた状態で提示します。調整後、サンプル会話を再生成します。

差分ベースの再生成 — 単一次元の変更後：

1. 変更を明示的に表示：「温かさ：温かい → クール」
2. すべての変更されていない次元を一定に保つ
3. 変更された次元のみを変更して、サンプル会話を再生成
4. ユーザーが次元変更を出力の動作上の差異に接続できるように、出力で何がシフトしたかを説明します

その他（フリーテキスト追加）

ユーザーが標準フレームワークコンセプトに適合しない何かを追加する必要がある場合は、受け入れてください。入力をレビューします：

• 既存フレームワーク要素（トーン境界、フレーズブック入力、語彙用語など）に自然にマップする場合は、それをそこに組み込むことを提案し、承認を求めます。
• 適合しない場合は、ユーザーが生成したテキストをペルソナドキュメントにカスタムセクションとして挿入し、エンコード出力に含まれていることを確認します。

語彙

語彙はオプションです。概念を紹介します：トピックごとにスコープされたドメイン語彙。重要な単語を集めます — 特に特定のトピックに固有の単語。フレーズブックから明確にする：

• フレーズブック = エージェントが一般的な状況（確認応答、リダイレクト、祝い）でどのように聞こえるか
• 語彙 = エージェントが特定のドメイン（技術用語、ブランド言語、業界専門用語）で使用する特定の単語と用語

完了

ユーザーが「完了しました」を選択した場合は、ペルソナドキュメントがまだ保存されていない場合はダウンロードを提供します。生成されたものと、ファイルが書き込まれた場所の最終サマリーを表示します。クリーンな出口。

---

スコアリング

ペルソナドキュメントを50ポイントのルーブリックに対してスコアします。スコアリングはオンデマンド — ユーザーが要求したときにトリガーされます。

スコアリング前に、 簡潔な方向付けサマリーを表示します（インタラクション設計を参照）。次に、スコアカードをインラインで表示します。表示後、_local/generated/[agent-name]-persona-scorecard.mdに保存する提供をします。その後、ハブメニューに戻ります。

バイアスのないスコアの場合、生成されたペルソナでスコアリングルーブリックを実行する別の人がいます。

カテゴリ	/10	基準
アイデンティティコヒアレンス	/10	• 特性が異なる、矛盾しない、行動的に定義 — 観察可能な動作、志向ではない • 設計入力が存在し、一貫性がある：オーディエンス → レジスター、モダリティ → チャット スタイル、会社 → 参照フレーム
次元の一貫性	/10	• 各次元がアイデンティティと一貫性がある、制約が尊重される • トーン境界が感情色/共感と一貫性がある；トーン柔軟性が範囲内 • チャット スタイルがモダリティに適応（電話で抑制される）
行動的特異性	/10	• 具体的な行動サンプル、テスト可能なルール • 使用禁止≥5（チャットボットフィラー + レジスター違反 + ペルソナ固有） • グローバル語彙が入力されている • ブランドガイド：抽出の深さ — 語彙、フォーマッティング、使用、CTA がキャプチャされていますか？
フレーズブック品質	/10	• 適用可能なカテゴリごとに2～4フレーズ • すべてのエージェント：確認応答、肯定、謝罪（間違いのみ）、オフトピックリダイレクト、ウェルカム • 条件付き：エスカレーション/ハンドオフ（外部）、進捗を祝う（励ましている）、教える瞬間（コーチ）、ユーモアの例（ユーモア≠なし） • フレーズがレジスターと次元に一致する • ブランドガイドコンテンツがキャプチャされている
サンプル品質	/10	• ペルソナが次元テーブルなしで認識可能 • ハッピーパス + 不確実性 + 境界シナリオ • モダリティ適切（電話：簡潔性の再調整、フォーマッティング抑制） • ブランド語彙が自然に表示される

スコアリング規則：

• 各カテゴリを個別にスコアします。数値と1～2文の正当化を提供します。
• 次元間の矛盾にフラグを立てます。生産的な緊張vs矛盾に注記します。
• カテゴリが7未満でスコアする場合は、改善のための具体的な提案を提供します。
• 合計：45-50本番対応、35-44強力な基盤、25-34改定が必要、25以下再開。

---

エンコードフロー

既存のペルソナドキュメントをツール固有の出力にエンコードするためのスタンドアロンエントリーポイント。ユーザーが完成したペルソナ.mdを提供する場合、または設計フロー後にアクセス可能です。

エンコードアーキテクチャについてはreferences/persona-encoding-guide.mdを、出力構造についてはassets/persona-encoding-template.mdを参照してください。音声選択とチューニングはプライマリエンコードフロー外にあります — モダリティに電話やその他の音声出力が含まれる場合は、参考としてのみreferences/persona-encoding-guide-voice.mdを使用してください。

エンコード前に、 簡潔な方向付けサマリーを表示します（インタラクション設計を参照）。エージェント名、オーサリングツール、オーディエンス、モダリティを確認します。

エンコーディングコンテキスト

会社、オーディエンス、モダリティはデザイン中に収集されます（ステップ2）。エンコーディングはそれらを継承します — 再度質問しないでください。エンコードに必要なものだけを収集します：

1. エージェントオーサリングツール — 「Agentforce BuilderまたはAgent Scriptにエンコードしていますか？」
2. トピック （オプション） — 「定義されたトピックがありますか？トピックごとのエンコーディングは簡潔性、トーン柔軟性、および語彙を各トピックに合わせます。」提供されている場合は、トピックごとのペルソナ指示を生成します。ユーザーが辞退した場合は、「いいえ、いくつかの例を生成します。」その場合、ペルソナコンテキストから2～3の妥当なトピックを推論し、トピックごとのペルソナ指示を生成し、明確にラベル付けします：「これらはペルソナコンテキストから推論された例です — 実際のトピックで置き換えてください。」
3. アクション （オプション） — 「定義されたアクションがありますか？アクションごとのエンコーディングは、ユーザーが待機中に見るイン・キャラクター読み込みテキストを生成します。」提供されている場合は、各アクションについてペルソナ一貫性のある読み込みテキストを生成します。ユーザーが辞退した場合は、「いいえ、いくつかの例を生成します。」その場合、ペルソナコンテキストから2～3の妥当なアクションを推論し、各アクションについてイン・キャラクター読み込みテキストを生成し、明確にラベル付けします：「これらはペルソナコンテキストから推論された例です — 実際のアクションで置き換えてください。」

ユーザーは全体エンコーディングのみを行い、後でトピックとアクションで戻ることができます。

生成

Agent Scriptの場合

出力ペーストでき、YAML ブロック：

システムブロック：

1. config.agent_name — ペルソナ名。
2. system.instructions — YAML リテラルブロックスカラー（|）としての完全なペルソナコンテンツ：アイデンティティ、次元行動ルール、フレーズブック、チャット スタイルルール、トーンルール、トーン境界、使用禁止リスト。文字数制限なし。
3. system.messages.welcome — 静的なイン・ペルソナウェルカムメッセージを生成します。マルチモーダルエージェントに電話チャネルがある場合は、2つ生成します：テキストウェルカムとより短い電話ウェルカム（耳最適化、AI開示を含む）。静的にデフォルト；補足としての動的なオプションに注記します。
4. system.messages.error — 静的なイン・ペルソナシステムエラーメッセージを1つ（1つ）生成します。このフィールドでは動的オプションは利用できません。

トピックごとのオーバーライド（トピックが提供される場合）： 5. reasoning.instructionsトピックごと — ペルソナ調整：簡潔性、語彙、トーン柔軟性、フレーズブックエントリ、ユーモア指導、ペルソナリマインダー。 6. トピックレベルsystem:オーバーライド — トピックのトーン柔軟性がシステムレベルのオーバーライドを保証する場合のみ。稀。

アクションごとのローディングテキスト（アクションが提供される場合）： 7. **progress_indicator_message**アクションごと — イン・キャラクター読み込みテキストinclude_in_progress_indicator: Trueと共に。

決定論的応答の例： 8. if/else ブランチ用の例| textパイプはペルソナの音声で書かれています。

電話調整（モダリティに電話が含まれる場合）： 9. 指示調整 — 簡潔性再調整ノート（電話の場合は1ポジション短い）、フォーマッティング抑制（絵文字なし、箇条書き → 序数）、構造化データの一時停止ガイダンス。

Agentforce Builderの場合

エージェント設定フィールド：

1. 名前（80文字） — 文字数を表示します。
2. 役割（255文字） — 機能的サマリーのみ：エージェントが何をし、誰に提供するか。「あなたは...」ペルソナスタイルをここにエンコードしない、。文字数を表示します。
3. 会社（255文字） — ステップ2で収集した会社コンテキストから入力します。文字数を表示します。
4. ウェルカムメッセージ（800文字、≤255を目指す） — アイデンティティ + レジスター + 音声 + トーン + 簡潔性を反映する静的なイン・ペルソナウェルカムメッセージを生成します。マルチモーダルエージェントに電話チャネルがある場合は、2つ生成します：テキストウェルカムとより短い電話ウェルカム（耳最適化、AI開示を含む）。文字数を表示します。
5. エラーメッセージ — 形式性 + 温かさ + 感情色 + 簡潔性を反映する静的なイン・ペルソナシステムエラーメッセージを1つ（1つ）生成します。

Agentforce Builder設定： 6. トーンドロップダウン — レジスター + 形式性に基づいて推奨します。それが粗い近似であることに注記します。 7. ウェルカムスクリーンの会話推奨 — ユースケースが定義されている場合はオン；オープンエンドの場合はオフ。 8. エージェント応答の会話推奨 — プロアクティブエージェントの場合はオン；ソクラテス的エージェントの場合はオフ。

グローバルペルソナブロック： 9. グローバル指示 — すべてのペルソナセクションから統合された完全なペルソナコンテンツ。

トピックごとのペルソナ指示（トピックが提供される場合）： 10. 簡潔性調整、フレーズブックエントリ、語彙用語、トーン柔軟性トリガー、ユーモア指導を備えたトピックごとの調整指示。

読み込みテキスト： 11. アクションごとの読み込みテキスト — 特定のアクションが提供された場合は、各アクションのペルソナ一貫性のある読み込みテキストを生成します。ユーザーが「いくつかの例を生成する」を選択した場合は、2～3の妥当なアクションを推論し、各アクションについてイン・キャラクター読み込みテキストを生成し、例として明確にラベル付けします。

電話調整（モダリティに電話が含まれる場合）：上記のAgent Script電話調整と同じアイテム。

出力

インラインレビューのためのエンコード値を提示します。文字制限フィールド（名前、役割、会社、ウェルカム、エラー）は文字数を含むインラインで表示されます。無制限フィールド（グローバル指示、トピックごとの指示）は表示するには長すぎます — 文字数を含むサマリーを表示し、完全なコンテンツをファイルに書き込みます。

Writeツールを使用してエンコード出力を書き込みます。デフォルトパス：_local/generated/[agent-name]-persona-encoding.md。その後、ハブメニューに戻ります。

---

出力

スキルは最大4つの Markdown ファイルを生成します：

1. ペルソナドキュメント（_local/generated/[agent-name]-persona.md） — assets/persona-template.md構造に従います。エージェントが誰であるか、どのように聞こえるか、何をしないかを定義する設計アーティファクト。
2. サンプル会話（_local/generated/[agent-name]-sample-dialog.md） — assets/sample-dialog-template.md構造に従います。会話でのペルソナを示す検証アーティファクト。
3. スコアカード（_local/generated/[agent-name]-persona-scorecard.md） — 50ポイントルーブリック評価。リクエスト時に生成されます。
4. エンコード出力（_local/generated/[agent-name]-persona-encoding.md） — assets/persona-encoding-template.md構造に従います。ツール固有：Agentforce Builderフィールド値と設定、またはAgent Script YAMLブロック。エンコードフロー経由のリクエスト時に生成されます。