用途:在任意项目中初始化、更新或全量覆盖 Claude Code 状态栏配置,通过预设模板快速搭建状态栏显示功能。
主要能力:配置完成后状态栏显示当前目录(~ 替换主目录)、Git 分支(🌿)、模型名称(🤖)、Claude Code 版本(v)以及剩余上下文窗口百分比(🧠,按剩余量着色:>40% 绿色、20%-40% 黄色、<20% 红色)。脚本支持 ANSI 颜色、自动检测 jq 并优雅降级、Git 分支或 commit hash 显示。
使用方式:技能目录含 SKILL.md 与 templates/settings.json、templates/statusline.sh。执行时先检查并创建 .claude/ 目录;settings.json 不存在则用模板创建,已存在则通过 AskUserQuestion 询问合并配置、全量覆盖或跳过;statusline.sh 已存在时询问是否覆盖,否则直接创建;最后验证 JSON 有效性与脚本 shebang。settings.json 模板内容为 {"statusLine": {"type": "command", "command": "bash .claude/statusline.sh", "padding": 0}}。
适用场景:新项目搭建状态栏、自定义或更新状态栏配置、状态栏显示异常时修复。
限制与依赖:bash 必需;git、jq 为可选依赖,缺失时降级。Windows 需安装 bash(Git Bash、WSL 等);终端不支持颜色时可设 NO_COLOR 禁用。覆盖现有文件前必须询问用户,并确保 settings.json 为有效 JSON、statusline.sh 保留 #!/bin/bash。
参考:Claude Code 文档 https://code.claude.com/docs/zh-CN/skills ;技能最佳实践 https://platform.claude.com/docs/zh-CN/agents-and-tools/agent-skills/best-practices 。