xs-xangi-settings

xangi 設定変更スキル

チャットから xangi の設定確認、設定ファイル変更、反映再起動を行う。

基本方針

xangi 本体の設定項目や運用コマンドは変わる。スキル内の古い一覧だけで判断せず、作業前に対象 clone の一次情報を読む。

読む順番:

1. [XANGI_ROOT]/docs/usage.md の環境変数・service・再起動まわり
2. [XANGI_ROOT]/.env.example
3. [XANGI_ROOT]/src/prompts/xangi-commands-chat-platform.ts（チャット上でAIに注入される最新運用ルール）

[XANGI_ROOT] は設定変更対象の xangi clone。[WORKSPACE] はこのワークスペース。

実行フロー

Step 1: 対象インスタンスを特定

複数の xangi clone が同じマシンで動くことがあるため、まず対象 clone を決める。

# 実行中コンテキストが xangi 上なら cwd/repo を確認
pwd
git rev-parse --show-toplevel 2>/dev/null

# xangi clone 候補と設定ファイルを確認
find "$HOME" -maxdepth 2 -name .env -path "$HOME/xangi-*/*" -print 2>/dev/null

# WORKSPACE_PATH / XANGI_INSTANCE_ID / XANGI_PROCESS_NAME / DATA_DIR を見て対象を絞る
for f in "$HOME"/xangi-*/.env; do
  [ -f "$f" ] || continue
  echo "## $f"
  grep -E '^(WORKSPACE_PATH|XANGI_INSTANCE_ID|XANGI_PROCESS_NAME|DATA_DIR)=' "$f" || true
done

判定の目安:

• 現在の Discord / Slack / Web Chat / LINE セッションを動かしている clone を優先
• WORKSPACE_PATH がこのワークスペースを指す clone を優先
• XANGI_PROCESS_NAME は ./bin/xangi service ... の PM2 対象名
• Docker運用では host 側の compose / 設定ファイルを対象にし、コンテナ内だけを書き換えない

Step 2: 最新ドキュメントを確認

対象 clone が /path/to/xangi なら:

cd /path/to/xangi
rg -n "service start|service stop|service restart|service status|XANGI_PROCESS_NAME|TIMEOUT_MS|CHANNEL_OVERRIDES|AUTO_REPLY_CHANNELS|SLACK_AUTO_REPLY_CHANNELS|system_settings|system_restart" \
  docs/usage.md .env.example src/prompts/xangi-commands-chat-platform.ts

運用ルールの現在形:

• 起動・停止・再起動・状態確認は対象 clone の ./bin/xangi service start|stop|restart|status を使う
• PATHから使う場合は xangi-dev / xangi-prod のような名前付き symlink を使う
• xangi tool system_restart は起動中プロセスに graceful shutdown を要求する低レベル操作
• system_settings は確認用。AI は system_settings で設定変更しない
• 設定ファイル変更後は対象 clone で ./bin/xangi service restart する

Step 3: 要望の種類を判定

• 設定確認 → Step 4a
• 設定変更 → Step 4b

Step 4a: 設定確認

cd /path/to/xangi

# service 状態
./bin/xangi service status

# 現在の設定を確認（トークン等は表示しない）
grep -vE '(TOKEN|SECRET|PASSWORD|API_KEY)=' .env | grep -v '^#' | grep -v '^$'