hersona-recommend-quiz

hersona-recommend-quiz

Overview

hersona 診断クイズを ユーザーとして体験する側 のスキル。hersona-recommend-engine（engine 開発側）の対となる skill。

やることは単純:

1. hersona/data/quiz/recommend_quiz.yaml から 9 問を読む
2. 1 問ずつ番号付き選択肢を提示し、番号を集める
3. key=index 形式の文字列を組み立てて hersona recommend --answers "..." --explain --json を実行
4. 結果 JSON を Markdown 整形（Telegram / Discord / ターミナル全対応）で返す

LLM 主軸: 通常のチャットセッションでは、エージェントが SKILL.md を読んで Q1〜Q9 を表示し、ユーザーの番号を --answers に変換して CLI を叩く。

ヘルパー同梱: scripts/run_quiz.py を同梱し、TTY がない環境（cron / バッチ / CI / 自動テスト）ではこっちで stdin 経由に 9 問進行 → --answers 生成 → 結果整形まで一括実行できる。

When to Use

• 「hersona で recommend して」「診断クイズやりたい」「キャラ診断して」「属性推薦して」など、ユーザーがクイズを プレイしたい とき
• 結果（採用された属性 blend / 根拠 / 代替案 / サマリ / 推奨強度）を Markdown で見やすく 受け取りたいとき
• TTY がない自動化経路（cron / テスト）で recommend を使いたいとき → scripts/run_quiz.py

Don't use for:

• クイズ YAML / WeightMagnitude / 閾値 / テストの 追加・編集（→ hersona-recommend-engine）
• 新しい属性 YAML の 追加（→ hersona-attribute-development）
• ペルソナをセッションにアタッチする作業（→ hersona の attach / recommend セクション）
• hersona リポジトリの戦略的・複数 PR 横断の作業（→ hersona-project-operations）

The 9 Questions (固定 ID)

クイズの本体は hersona/data/quiz/recommend_quiz.yaml にあり、9 問。各質問は次の ID で固定（= CLI --answers のキー）。ID を変えるとユーザーの既存スクリプトが壊れるので SKILL.md / YAML をまたいで常に同期すること。

ID	軸	質問
distance	personality	相手との距離感は？
emotion	personality	感情の出し方は？
speech	speech	どんな話し方が好み？
role	archetype	物語での立ち位置は？
hobby	hobby	趣味・ライフスタイルで近いのは？
appearance	visual	外見・雰囲気で近いのは？
lifestyle	lifestyle	日常の過ごし方は？
interaction	interaction	人と接するときは？
cultural	cultural	文化的・知的なバックグラウンドは？

選択肢の最新版は必ず YAML から読む（= 同梱禁止、コードと YAML の二重管理を避ける）。LLM フローの冒頭で read_file で YAML を読み込み、表示用テキストを生成する。

i18n (Phase 3〜): prompt / label は BASE=en。日本語は各質問・各選択肢の i18n: {ja: {prompt|label: "..."}} に入る（上表は日本語版 = i18n.ja.prompt）。 表示言語に合わせて i18n.<lang> を優先し、無ければ BASE(en) にフォールバックして出すこと。

LLM Flow (manual / interactive)