statusline-setup

name	statusline-setup
description	安裝並設定 Statusline Kit。自動偵測環境，複製腳本、建立設定檔、更新 settings.json。當使用者提到「安裝 statusline」、「statusline setup」、「設定狀態列」時觸發此 Skill。
user_invocable	true

Statusline Setup — 安裝精靈

一鍵安裝 Statusline Kit 到使用者環境。

---

流程

1. 偵測安裝目標

自動偵測安裝路徑，不詢問使用者：

• ~/.claude-company/ 目錄存在 → 安裝到 ~/.claude-company/
• 否則 → 安裝到 ~/.claude/

同時偵測 settings.json 位置：安裝目標目錄下的 settings.json。

若 settings.json 不存在，告知使用者並結束。

2. 檢查 jq 依賴

command -v jq

若不存在，提示使用者安裝（macOS: brew install jq、Ubuntu: sudo apt install jq）後結束。

3. 選擇模版

用 AskUserQuestion 讓使用者選擇初始模版：

• standard（推薦）— model, context_bar, context_tokens, cost, duration, lines, git_branch
• minimal — model, context_bar, cost
• dev — model, context_bar, cost, duration, api_duration, lines, git_branch, git_dirty, thinking
• full — 全部 12 個欄位

4. 安裝檔案

4a. 複製 statusline.sh

從 plugin 目錄複製腳本到安裝目標：

cp {plugin_base_dir}/scripts/statusline.sh {安裝目標}/statusline.sh
chmod +x {安裝目標}/statusline.sh

{plugin_base_dir} 是此 SKILL.md 的上兩層目錄（即 statusline-kit/）。

用 Bash 工具執行複製，不要用 Write 工具重寫腳本內容。

4b. 建立設定檔

讀取 {plugin_base_dir}/references/default-config.json 作為基底，按使用者選擇的模版修改 fields，然後用 Write 工具寫入 {安裝目標}/statusline-config.json。

模版定義參考 {plugin_base_dir}/references/templates.md。

4c. 更新 settings.json

讀取 {安裝目標}/settings.json，新增或更新 statusLine 欄位：

"statusLine": {
  "type": "command",
  "command": "bash \"$HOME/{相對路徑}/statusline.sh\""
}

• {相對路徑} 根據安裝目標決定（.claude-company 或 .claude）
• 如果 statusLine 已存在，詢問使用者是否覆蓋
• 使用 Edit 工具修改，不要覆寫整個 settings.json

5. 驗證

執行一次 statusline 腳本驗證輸出：

echo '{"model":{"display_name":"Test"},"context_window":{"context_window_size":200000,"current_usage":{"input_tokens":1000,"output_tokens":0,"cache_creation_input_tokens":0,"cache_read_input_tokens":0},"used_percentage":1,"remaining_percentage":99},"cost":{"total_cost_usd":0,"total_duration_ms":0,"total_api_duration_ms":0,"total_lines_added":0,"total_lines_removed":0},"cwd":"/tmp","version":"2.1.79","exceeds_200k_tokens":false}' | bash {安裝目標}/statusline.sh

6. 完成提示

## Statusline Kit 安裝完成

- 腳本: {安裝目標}/statusline.sh
- 設定: {安裝目標}/statusline-config.json
- 模版: {選擇的模版}
- settings.json: 已更新

### 使用方式
- `/session-info` — 查看完整 session 資訊
- `/session-info config` — 互動調整顯示欄位
- `/session-info template <名稱>` — 快速切換模版（minimal / standard / full / dev / monitor）

狀態列會在下次 Claude Code 更新畫面時自動生效。

---

注意事項

• 不要修改使用者的 settings.json 中 statusLine 以外的設定
• 如果已有 statusline 設定，先備份再覆蓋
• jq 是必要依賴，安裝前檢查