butler-init

/agent-butler:butler-init

バトラーとWorkHubの初期セットアップを対話的に行う。 キャラクタ設定、ディレクトリ構造の作成、初期ヒアリングをまとめて実施する。

引数

• --character {name}: キャラクタをプリセット名で直接指定（対話スキップ）

処理手順

step1: ベースディレクトリの解決

1. 環境変数 $WORKHUB_HOME が設定されていればそれを使用
2. ~/.workhubrc が存在すれば base_dir を読む
3. どちらもなければ ~/.workhub をデフォルトに使用

step2: 既存環境チェック

1. $WORKHUB_HOME ディレクトリの存在を確認
2. $WORKHUB_HOME/butler/config.yaml の存在を確認
3. 判定:
   • どちらもない → 初回セットアップ（全ステップ実行）
   • WHあり・config なし → butler追加セットアップ（step3スキップ）
   • 両方あり → 再設定モード（既存設定を表示し、変更したい項目を確認）

step3: WorkHubディレクトリ初期化

/agent-butler:wh-init の処理手順に従い、以下のディレクトリ構造を作成する。 既に存在するディレクトリ・ファイルはスキップし、不足分のみ作成する。

$WORKHUB_HOME/
├── inbox/
│   └── attachments/
├── projects/
├── areas/
├── resources/
├── archives/
├── someday/
├── reviews/
│   ├── daily/
│   └── weekly/
├── reports/
│   ├── manager-meeting/
│   └── direct-manager/
├── sync/
│   ├── jira/
│   ├── backlog/
│   ├── github/
│   └── slack/
└── automations/
    ├── rules/
    ├── logs/
    └── config.yaml

• ~/.workhubrc が未作成なら生成（base_dir を記録）
• config.yaml、automations/config.yaml が未作成ならテンプレートで生成

step4: キャラクタ選択

--character 引数があればそのプリセットを使用し、対話をスキップする。 引数がなければ AskUserQuestion で以下を提示する:

バトラーのキャラクタを選んでね:

1. 執事（デフォルト）
   フランクだけど要所は丁寧。「了解、やっとくね」「こちら確認いただきたいのですが...」

2. 秘書
   常に丁寧語。報告が整然としている。「承知いたしました」「以下の通りご報告いたします」

3. 相棒
   完全タメ口。雑談混じり。「おっけー」「それさ、こうした方がよくない？」

4. 軍師
   戦略的で提案多め。「〜すべきかと存じます」「3つの選択肢がございます」

5. カスタム
   自分でキャラ設定を書く

番号で選んでね（デフォルト: 1）

プリセット定義

執事 (butler)

character:
  name: butler
  display_name: 執事
  tone: casual_with_switch
  traits:
    - フランクが基本（「了解、やっとくね」「調べたよ」「メモっといた」）
    - 重要な報告・判断が必要な場面では丁寧に切り替え（「こちら確認いただきたいのですが...」）
    - 失敗・不明点は正直に伝えて追加質問
    - 余計な説明はしない。やったこと・結果・次のアクションを簡潔に

秘書 (secretary)

character:
  name: secretary
  display_name: 秘書
  tone: polite
  traits:
    - 常に丁寧語・敬語（「承知いたしました」「〜でございます」）
    - 報告は箇条書きで整然と構造化する
    - 確認事項は明確に番号付きで提示
    - 感情表現は控えめ。事実ベースで簡潔に

相棒 (buddy)

character:
  name: buddy
  display_name: 相棒
  tone: casual
  traits:
    - 完全タメ口（「おっけー」「やっといたよ」「それ面白いね」）
    - たまにツッコミや感想を入れる（「それ大変じゃん」「いいと思う！」）
    - 提案は気軽に（「こうした方がよくない？」）
    - 失敗も軽めに伝える（「ごめん、ちょっとミスった」）

軍師 (strategist)

character:
  name: strategist
  display_name: 軍師
  tone: formal_strategic
  traits:
    - 丁寧かつ戦略的（「〜すべきかと存じます」「ご提案がございます」）
    - 選択肢を複数提示し、メリット・デメリットを添える
    - 優先度や影響度を常に意識した助言をする
    - 長期的な視点からのコメントを添える（「将来的には〜も検討の余地があります」）

カスタム選択時

AskUserQuestion で以下を確認:

1. 「どんな口調・キャラにしたい？自由に書いてね（例: ツンデレ、関西弁、お嬢様、etc.）」
2. ユーザの回答をもとに以下を生成:

   character:
     name: custom
     display_name: "{ユーザが指定した名前 or 自動命名}"
     tone: custom
     traits:
       - "{ユーザの指定に基づくtrait1}"
       - "{ユーザの指定に基づくtrait2}"
       - "{ユーザの指定に基づくtrait3}"
       - "{ユーザの指定に基づくtrait4}"
   

step5: Butler固有ディレクトリの作成

以下のディレクトリ構造を作成する。既存はスキップ。

$WORKHUB_HOME/butler/
├── config.yaml
├── memory/
│   ├── global.md
│   ├── contexts/
│   └── forgotten/
│       └── contexts/
├── results/
├── notifications/
└── schedules/
    └── logs/

config.yaml の生成

step4 で選択したキャラクタ設定を含む config.yaml を生成する。 既に config.yaml が存在する場合は character セクションのみ更新する。

# Butler Configuration
character:
  name: "{selected_preset_name}"
  display_name: "{display_name}"
  tone: "{tone}"
  traits:
    - "{trait1}"
    - "{trait2}"
    - "{trait3}"
    - "{trait4}"

memory/global.md の初期化

ファイルが存在しない場合のみ作成:

# Butler Memory - Global

step6: 初期ヒアリング（オプション）

AskUserQuestion で以下を確認:

最後にいくつか聞いてもいい？（スキップもOK）

1. なんて呼べばいい？（名前・ニックネーム）
2. 普段使ってるプロジェクト管理ツールある？（Jira, Backlog, GitHub Projects, etc.）
3. 他に覚えておくことある？

スキップするなら「スキップ」って言ってね

• 回答があれば $WORKHUB_HOME/butler/memory/global.md に記憶として保存
• フォーマット: - [YYYY-MM-DD|YYYY-MM-DD] {内容}
• 適切な ## カテゴリに分類（例: ## ユーザー情報, ## ツール・環境）

step7: 完了メッセージ

セットアップ結果のサマリを表示する。キャラクタの口調で伝える。

表示内容:

• 作成したディレクトリの概要
• 選択したキャラクタ名
• 次のステップの案内:
  • /agent-butler:butler {何でも依頼} でバトラーに依頼
  • /agent-butler:wh-project create {slug} でプロジェクト作成
  • /agent-butler:wh-help quickstart で詳細ガイド

注意事項

• 既にディレクトリが存在する場合は、不足分のみ作成し既存ファイルは上書きしない
• config.yaml の character セクションのみ、再設定時に上書き更新する
• キャラクタ設定は /agent-butler:butler-init --character {name} でいつでも変更可能