Skip to main content

soul とは

soul は MineClawd のキャラクターシートです。 エージェントが誰で、どう話し、人とどう関わるかを定義します。 タスク用スクリプトではなく、人格として考えてください。
  • 良い soul 内容: アイデンティティ、気質、口調、対人行動。
  • 悪い soul 内容: 長いコマンド手順、ツール指示、単発ワークフロー手順。
soul が別のキャラクター名を使っていても、プロジェクト名とツール名のアイデンティティは MineClawd のままです。

組み込み soul

MineClawd には次が同梱されています:
  • default
  • yuki
yuki はマスコット風 soul で、構成の良い参考例です。

soul ファイルの場所

  • soul ディレクトリ: mineclawd/souls/
  • owner ごとのアクティブ soul ポインタ: mineclawd/souls/.active/<owner>.txt
同じサーバーでも、オペレーターごとに異なるアクティブ soul を使えます。

soul の表示と切り替え

リクエスト実行中は soul を切り替えられません。 完了を待ってから /mineclawd persona <soul> を実行してください。

カスタム soul の作成

  1. mineclawd/souls/ に Markdown ファイルを作成します。例: mineclawd/souls/mentor.md
  2. 下記構造で persona 内容を書きます。
  3. /mineclawd persona mentor を実行します。
  4. 通常プロンプトをいくつか送り、話し方を調整します。

soul 記述テンプレート

実践のコツ

  • 感情トーンは全セクションで一貫させてください。
  • 曖昧な形容詞より、具体的な話し方の手がかりを優先してください。
  • 運用動作は soul ファイルではなく、プロンプトとドキュメントに書いてください。
  • 独自 soul を設計する前に、同梱の yuki.md を読んでください。