# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

BACH エージェント システム
==================

ペルソナ システムを備えたボス エージェントとエキスパートの階層システム。

3 つのレベル
-----------

  スキル 実質的。知識、コード、ワークフロー。
             ポータブルでエクスポート可能な、真の価値。

  ペルソナ インターフェイス。名前、スタイル、性格。
             パーソナライズ可能 (バッハ エージェントの名前変更)、好みの問題です。

  セッション 期間。コンテキスト ウィンドウ、ツール、ターン。
             技術的な詳細。

構造
--------

ボスエージェントが調整し、専門家が専門:

  【ボスエージェント】
       |
       +-- [エキスパート 1]
       +-- [エキスパート 2]


利用可能なエージェント (agents/)
-------------------------------------

[プロフェッショナル]

  ATI (ati/) — ペルソナ: アトラス
    スキャナーを備えたソフトウェア開発者エージェント、セッション
    機能: タスク スキャナー、ヘッドレス セッション、ツール ディスカバリ

  開発者（開発者）
    一般開発者エージェント

  生産
    本番ワークフロー エージェント

  研究
    科学研究 (PubMed、パープレキシティ、コンセンサス)

  オフィスアシスタント (オフィスアシスタント) — ペルソナ: クララ
    税金、資金計画、書類作成
    専門家: 税務 (Theodor)、資金調達プランナー (Florian)

  反射
    内省とメタ分析


[プライベート]

  パーソナル アシスタント (パーソナル アシスタント) — ペルソナ: Paul
    予約管理、リサーチ、コミュニケーション
    専門家: 家計管理 (マーサ)

  ヘルス アシスタント (ヘルス アシスタント) — ペルソナ: ヘレナ
    医療文書と管理
    専門家: 保健管理者 (グスタフ)、心理カウンセラー (ソフィー)

  保険（保険）
    保険管理

  Financial Assistant (財務アシスタント) — ペルソナ: Felix
    財務計画と予算編成


[テスト]

  テストエージェント (テストエージェント)
    テストと実験用


ペルソナ システム (SUGAR v3.8.0)
------------------------------

SUGAR v3.8.0 以降、エージェントと専門家はペルソナに次の名前を付けています。
人間の名前 + データベース内のキャラクターの説明。

  DB列:
    display_name ペルソナの名 (例: "Atlas"、"Theodor")
    ペルソナ キャラクター テキスト (例: "実用的な職人...")

  コマンド:
    bach agent rename <name> <neuer-name>   表示名の変更
    bach agent list                          括弧内にペルソナを表示
    bach agent info <name>                   ペルソナを含む詳細

  名前解決 (resolve_agent_name):
    1. 正確なシステム名 (例: 「tax-agent」)
    2. 表示名 (例: 「Theodor」)
    3. 部分文字列 (例: "theo")
    4. ファジー/レーベンシュタイン (例: "teodor")

  ペルソナの注入:
    エージェントが起動すると、ペルソナがシステム プロンプトとして挿入されます。
    「あなたの名前は「テオドール」です。あなたのキャラクターは陰茎税務顧問です...」
    参照: Hub/agent_launcher.py (_get_persona_info)


  ボス エージェントのペルソナ:

    システム名 |ペルソナ |キャラクター
    アティ |アトラス |実用的な職人
    オフィスアシスタント |クララ |構造化されたオーガナイザー
    財務アシスタント |フェリックス |思いやりのある倹約家
    健康アシスタント |ヘレナ |思いやりのある仲間
    パーソナルアシスタント |ポール |万能なオールラウンダー


  専門家ペルソナ:

    システム名 |ペルソナ |キャラクター
    税務代理人 |セオドア |ペニスの税理士
    金融メール |フリーダ |メール探偵
    サブスクリプションサービス |アントン |キャンセル王
    医療管理者 |グスタフ |調査結果のアーキビスト
    心理コンサルタント |ソフィー |共感的な聞き手
    健康インポート |ヒューゴ |誠実なデータ管理者
    予算管理 |マーサ |倹約家政婦
    ファンディングプランナー |フロリアン |資金調達の専門家
    アプリケーションエキスパート |ベンジャミン |キャリアコーチ
    データ分析 |ダイアナ |ナンバーウィスパラー
    決定ブリーフィング |ディートリッヒ |クールな戦略家
    レポートジェネレーター |リタ |効率的なレポートエンジン
    ちくたっく | TikTokさん |戦略家
    文字起こしサービス |トリスタン |患者の聞き手
    ウィキクイズ |ウィリアム |クイズマスター

  テンプレート: skill/_templates/TEMPLATE_PERSONA.md
  移行: data/schema/migrations/034_agent_personas.py


CLI コマンド
-----------

  # エージェントをリストする
  bach --agents list
  Python ツール/agent_cli.py リスト

  # 専門家を表示
  Python ツール/agent_cli.py エキスパート

  # エージェントの詳細
  python tools/agent_cli.py info <エージェント名>

  # ペルソナの名前を変更する
  bach agent rename <name> <neuer-display-name>

# ユーザーフォルダの初期化
  python tools/agent_cli.py すべて初期化
  python tools/agent_cli.py init <エージェント名>

  # データベースをセットアップする
  python tools/agent_cli.py setup-db

  # システムステータス
  Python tools/agent_cli.py ステータス


ディレクトリ
-------------

  エージェント/Boss エージェント定義 (11 エージェント)
  Agents/_experts/ CONCEPT.md を含む Expert フォルダー (17 人のエキスパート)
  user/<agent>/ エージェントごとのユーザー データ フォルダー

重要: エージェントとエキスパートは異なる概念です。
  - エージェント (上司): 調整および委任 (agents/)
  - エキスパート: 特化した実行 (agents/_experts/)
  - ヘルプにリストされている一部の「エージェント」は実際には専門家です。
    * 税務代理人 -> _experts/tax/
    * ファンディング プランナー -> _experts/foerderplaner/
    * 予算管理 -> _専門家/予算管理/
    * 心理コンサルタント -> _experts/psycho-consultant/


データベース
-----------

  バッハ.db:
    - bach_agents (エージェント レジストリ + 表示名 + ペルソナ)
    - bach_experts (エキスパート レジストリ + 表示名 + ペルソナ)
    - Agent_synergies (エージェント間の相乗効果)

  バッハ.db:
    - 専門家ごとのテーブル (health_*、世帯_* など)


ワークフロー
--------

1。エージェントをアクティブ化する(スキルまたはCLI経由)
2. エージェントはスキル定義とユーザーデータをロードします
3. ペルソナはシステム プロンプトとして挿入されます (display_name + persona)
4. 特別なトピックの場合: 専門家への委任
5. 専門家が説明し、上司エージェントが要約


GUI
---

  http://127.0.0.1:8000/agents エージェントの概要
  http://127.0.0.1:8000/ati ATI エージェントの詳細
  http://127.0.0.1:8000/tax 税務担当者の詳細


ファイル
-------

  エージェント/ati/ATI エージェント フォルダー
  Agents/ati/ATI.md ATI 定義
  エージェント/パーソナルアシスタント.txt
  エージェント/healthassistant.txt
  エージェント/bueroassistant.txt
  エージェント/tax-agent.txt
  エージェント/リサーチ.txt
  エージェント/開発者.txt
  エージェント/production.txt
  Agents/README.md


STANDARDS
---------

必須ファイル:

  1. すべてのエージェントとエキスパートは SKILL.md を持っている必要があります
     (roll.txtやCONCEPT.mdではなく代替)
  2. SKILL.md には YAML-Frontmatter が含まれている必要があります。
     名前、バージョン、タイプ、説明 (最低限)
  3. CONCEPT.md はオプションです (詳細な概念用)
  4. role.txt は非推奨です (SKILL.md に移行)

ペルソナ システム (SUGAR v3.8.0 -- 実装):

  すべてのエージェントと専門家は DB 内に名前を付けたペルソナを持っています。
  ペルソナは、display_name (名) と persona (キャラクター) で構成されます。

  コンセプト：ペルソナ（誰が）＋スキル（何を）＋セッション（どのように）
    - ペルソナ：スタイルと境界線を備えたキャラクター（DB + オプションファイル）
    - スキル: コードと命令を使用する能力 (エクスポート可能)
    - セッション: ランタイム環境 (ツール、ターン、モデル)

  宛先指定: エージェントはペルソナ名を使用して宛先指定できます。
    (例: 「税金についてセオドアに聞いてください」)

  将来: Agent/personas/ 内のペルソナ ファイル (段階的移行)

人間的互換性:

  - スキルはエクスポート可能です (オープンスタンダード、LobeHub/Cursor など)
  - ペルソナ/エージェントは移植できません (クロード コード/BACH のみ)
  - エクスポート: バッハ スキル エクスポート <名前> --format anthropic
  - 新しいスキル: バッハ スキル <名前> を作成 --format anthropic

  参照: bach help skill_standards


関連項目
----------

  bach help skill_standards  人間のスキル標準
  bach help actors           アクターの概要
  bach help bach_paths       ディレクトリ構造
  bach help practices        アーキテクチャの原則
  bach help ati              ATI ソフトウェア開発者の詳細
  bach wiki lobehub          LobeHub マーケットプレイス
