soul-audit について
soul-auditは、インタビューを通じてエージェントのアイデンティティを見直すスキルです。ユーザーの回答を共有バンクに保存し、内容の読み上げ確認とバックアップを経て、レンダリング処理でファイルを更新します。
主な機能
- 01対話形式のアイデンティティ面談
- 02ユーザー回答の原文記録
- 03読み上げ確認後のファイル生成
- 04生成前のファイルバックアップ
- 05面談フェーズごとの再実行
活用シーン
- 01エージェントのアイデンティティや目標の見直し
- 02エージェントのコミュニケーションスタイル調整
- 03ユーザー情報やアクセス境界の更新
- 04定期チェックのスケジュール調整
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ garrytan/ gbrain --skill soul-auditインストール後、Claude Code で/soul-auditを入力して読み込まれたか確認します。
詳細
Soul Audit — エージェントのアイデンティティ構築(再実行/表面の掘り下げ)
ブートストラップ後であれば、いつでも対話形式のインタビューを通じてエージェントのアイデンティティを更新できます。このスキルはファイルを一から生成せず、アイデンティティの文章を自ら作成することもありません。ユーザーの回答を共有回答バンクに記録し、その後、ブートストラップのレンダリングエンジンにファイルを生成させます。これにより、どのインターフェース(初回起動時のブートストラップ、このスキル、将来の再監査)で回答を収集した場合でも、state/interview.json を唯一の信頼できる情報源として維持できます。
重要: 内容は、記録されたユーザー自身の回答をそのまま使用します。 アイデンティティに関する回答を、決して創作、脚色、またはデフォルト設定してはいけません。必須の回答が揃い、人間が読み返して確認するまで、レンダリングゲートは構造的にレンダリングを拒否します。
契約
このスキルでは、以下を保証します。
gbrain bootstrap interview --set KEY "value"を通じて、回答を共有バンクに保存します(回答ごとにキーを1つ使用し、--skip KEYは明示的な回答拒否を記録します)。- レンダリングの前に、必ず読み返しの手順を実行します。回答一式全体を
--showで表示し、その内容をユーザーに伝えたうえで、--statusに表示されたハッシュを使って--confirm <hash>を実行します。ユーザーが見ていない回答一式を確認しようとすると、意図的に失敗します。 - ファイルは唯一のレンダリング経路で再生成します。
gbrain bootstrap render --only SOUL.md --force(ファイルごとに繰り返します)。--forceは古いファイルを先に.gbrain-bootstrap-backups/<ts>/にバックアップするため、復元可能なコピーを残さずに上書きされることはありません。 - 各フェーズは独立しており、再実行できます。回答を1つ更新してファイルを1つ再生成すれば、完全かつ有効な実行となります。
コマンドの流れ
gbrain bootstrap interview --show # what the bank holds now (start here)
gbrain bootstrap interview --set KEY "..." # record one updated answer, verbatim
gbrain bootstrap interview --skip KEY # explicit decline for an optional key
gbrain bootstrap interview --status # gate + read-back hash
gbrain bootstrap interview --confirm <hash> # after reading answers back to the user
gbrain bootstrap render --only SOUL.md --force
レンダリング対象は SOUL.md、USER.md、ACCESS_POLICY.md、HEARTBEAT.md、AGENTS.md です(変更されたキーが影響するファイルを再生成してください)。OpenClaw のワークスペースでは、HEARTBEAT.md の対象が SCHEDULES.md に書き込まれます。OpenClaw 2026.10.6+ では、ワークスペースの HEARTBEAT.md が削除されるためです。レンダリング時にワークスペースが検出されます。または、--host openclaw を指定してください。
フェーズ(各フェーズは独立しており、再実行できます)
フェーズ 1:アイデンティティのインタビュー
次のように尋ねます。「あなたにとって、このエージェントはどのような存在ですか?リサーチパートナーですか?エグゼクティブアシスタントですか?思考のパートナーですか?それとも、これらすべてですか?」
キー:AGENT_NAME、AGENT_PURPOSE、SOUL_RELATIONSHIP。生成先:SOUL.md。
フェーズ 2:雰囲気の調整
コミュニケーションスタイルの例を3〜4つ提示します。
- フォーマル:「状況を包括的に分析しました……」
- 率直:「状況はこうです。重要なのは3つです。」
- 技術的:「根本原因はコネクションプーリングにあります。解決方法はこちらです。」
- カジュアル:「つまり、Xが原因で動かないってことです。簡単に直せます。」
どれがしっくりくるかを尋ねます。また、読んでいて顔をしかめた返答と、その理由も尋ねます。
キー:
VOICE_REGISTER、SOUL_WINCE、SOUL_MODE_DEFAULT。生成先:SOUL.md。
フェーズ 3:ミッションの整理
次のように尋ねます。「最優先の目標を3〜5個挙げてください。何を達成しようとしていますか?」
キー:AGENT_TOP_JOBS、SOUL_GOOD_OUTPUT、SOUL_WORLDVIEW。生成先:SOUL.md、
AGENTS.md。
フェーズ 4:ユーザープロフィール
次のように尋ねます。「あなた自身について教えてください。何をしていますか?今、何に取り組んでいますか?あなたの周囲で重要な人は誰ですか?」
キー:PRINCIPAL_NAME、PRINCIPAL_CONTEXT、PRINCIPAL_TIMEZONE。生成先:
USER.md。
フェーズ 5:境界
次のように尋ねます。「あなたの頭脳にアクセスできるのは誰ですか?一部だけを見せるべき人はいますか?完全にアクセスさせない人はいますか?」
キー:ACCESS_TIERS(継続的な開示に関するセクションも確認します)。生成先:
ACCESS_POLICY.md。
フェーズ 6:運用サイクル
次のように尋ねます。「エージェントからの確認はどのくらいの頻度がよいですか?朝のブリーフィングですか?終業時の要約ですか?定期的に実行したいジョブはありますか?」
キー:HEARTBEAT_CADENCE、QUIET_HOURS。生成先:HEARTBEAT.md(OpenClaw では SCHEDULES.md)。ジョブは無効の状態で提供されます。手動でのドライランを行ってから、1つずつ有効にしてください(手順は生成されたファイルに記載されています)。
回答バンクがまだ存在しない場合(ブートストラップを一度も実行していないワークスペース)は、まず gbrain bootstrap interview --init を実行してください。質問の一覧全体が表示されます。
出力形式
変更内容を正確に報告します。更新されたキー、再レンダリングされたファイル、バックアップの保存先を記載します。例:「Soul 監査:VOICE_REGISTER と SOUL_WINCE を更新し、SOUL.md を再レンダリングしました(バックアップは .gbrain-bootstrap-backups/... にあります)。 いつでも任意のフェーズを再実行できます。」
エラーが発生した場合
gbrain のエラー code、終了コード、[AGENT] ブロック、または通知ブロックについては、エージェントオペレータープロトコルに従ってください。このスキルに固有の事項:
gbrain bootstrap interview --confirm <hash>が失敗した場合:ハッシュは、ユーザーが実際に確認した読み返し結果から取得する必要があります。gbrain bootstrap interview --statusを再実行して回答を読み返し、ユーザーの同意を得てから確定してください。- 必須の回答が不足しているためレンダリングが拒否された場合:ユーザーに回答を尋ねてください。自分で本人性に関する回答を補ってはいけません。
アンチパターン
- ユーザーの言葉をバンクに記録するのではなく、自分で本人性に関する文章を書く (これらのファイルを作成するのはレンダーエンジンだけです)
- SOUL.md/USER.md を直接手編集する。次のレンダリングで上書きされます。ANSWER を編集してから再レンダリングしてください。
- ユーザーが確認していない回答の読み返しハッシュを確定する
- 監査を必須にする、または6つのフェーズすべてを一度に尋ねる(負担が大きくなります。各フェーズは独立しているため、完全さよりも勢いを大切にしてください)
- 事前入力された本人性情報を含めて提供する(プライバシー違反です)
- 個別のフェーズを再実行する方法を案内しない