Soul とは？
Soul は Alius の Agent アイデンティティシステムです。AI Agent の役割、専門知識、振る舞いを定義します。構造化された Agent ペルソナ設定と考えることができ、Alius では Agent Card 互換形式で表現されます。
Soul の影響範囲：
- Agent がリクエストをどのように理解し対応するかを決定
- プラン生成のスタイルとフォーカスに影響
- コードレビュー、デバッグなどのタスクの行動嗜好を設定
2レベルの Soul 管理
Alius は公式リポジトリキャッシュとローカルインストール済みキャッシュを区別します：
| コマンド | 管理レベル | 説明 |
|---|---|---|
alius core update | 公式リポジトリキャッシュ | 公式 Soul リポジトリキャッシュを更新またはクローン |
alius soul update | ローカルインストール済みキャッシュ | 公式 Soul をローカルキャッシュに同期 |
alius soul list | ローカルインストール済みキャッシュ | インストール済みの Soul キャッシュエントリを一覧表示 |
alius coreは公式リポジトリを管理し、alius soulはローカルインストールを管理します。これらは異なる操作です。
ワークスペースで Soul を設定
/init 初期化ウィザード経由
初期化ウィザードの最後のステップで Soul ロールを選択。選択は即時反映されます。
/config 設定センター経由
/config を入力し、Soul タブに切り替えて、Agent ロールを選択または変更します。
コマンドライン経由
alius config soul --role senior-engineer設定ファイルを直接編集
.alius/config/soul.toml を編集：
[soul]
role = "senior-engineer"
description = "テスト、クリーンコード、ドキュメントに注力するシニアソフトウェアエンジニア"
language = "ja"利用可能なロール
一般的な Soul ロール：
| ロール | 特徴 |
|---|---|
| senior-engineer | アーキテクチャ、コード品質、ベストプラクティスに注力 |
| code-reviewer | バグと改善点のコードレビューに特化 |
| docs-writer | ドキュメントとコメントの生成 |
| debugger | 診断と問題修正に注力 |
Soul とモデル割り当て
Soul ロールと Plan/Execute/Review モデル割り当ては独立した設定ディメンションです：
- Soul は Agent のアイデンティティと行動スタイルを定義
- モデル割り当て はどのモデルがどのフェーズを担当するかを定義
これらは /config 設定センターの異なるタブで管理されます。
Soul 選択の前提条件
/config または /init で Soul ロールを選択する前に、以下の条件を満たす必要があります：
- ローカルモデルライブラリに少なくとも1つの有効なモデルがある
- Plan Model、Execute Model、Review Model のそれぞれが有効なモデルに割り当てられている
- 選択されたモデルの参照プロバイダーに Base URL がある
- 選択されたプロバイダーに直接の API Key または API Key 環境変数ソースがある
Agent Card
プロジェクトの Soul 設定は .alius/config/soul.toml に Agent Card 互換形式で保存されます。Agent Card は Agent のアイデンティティ、能力、スキル、プロトコルの公開方法を記述します。