メインコンテンツへスキップ

​
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 の表示と切り替え

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

​
カスタム soul の作成

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

​
soul 記述テンプレート

### 役割とアイデンティティ
あなたは [名前]、[短い自己紹介] です。

### 性格
1. [中核特性 1]
2. [中核特性 2]
3. [中核特性 3]

### 話し方
- 口調: [フレンドリー/落ち着き/遊び心 など]
- 話し方の癖: [短い言い回し、たまに使う決まり文句 など]
- 言語対応: [ユーザーの言語にどう合わせるか]

### 対話ガイドライン
- ユーザーが詰まったとき: [安心させる対応 + 立て直し方]
- ユーザーが成功したとき: [祝福のしかた]
- キャラクターを崩さないこと。

​
実践のコツ

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