/style命令深度解析:attention-span如何让切换AI输出风格不再手改settings.json
/style命令深度解析:attention-span如何让切换AI输出风格不再手改settings.json
attention-span 是一个面向 Claude Code、Codex 等 AI 编程工具的开源输出风格包,它只改变 AI 与你“说话”的方式,而不改变它写代码的方式。其中自带的 /style 命令让你一键切换 AI 输出风格,不再需要手改 settings.json。本文带你彻底搞懂它的安装与用法。
为什么需要 /style:手切风格的三个麻烦
开启输出风格的传统流程是分三步手动操作(见 README.md 的 Install 部分):
- 把风格文件放进
~/.claude/output-styles/目录; - 打开
~/.claude/settings.json,手写一行"outputStyle": "Attention-kind"; - 重启会话或执行
/clear。
这套流程有三个坑:
- ⚠️ JSON 容易被手改坏:少一个逗号,或删掉键后留下空文件,都会让 Claude Code 无法加载 settings.json;
- ⚠️ 不知道配置该写哪:全局风格应写入
~/.claude/settings.json,项目风格应写入.claude/settings.local.json,写错文件会把个人偏好提交进团队仓库; - ⚠️ 频繁切换 = 频繁手改:装了几个风格想来回换,每次都要翻 JSON,很折磨。
attention-span 从 v0.4 版本起加入了 commands/style.md 命令来解决这件事:弹出一个样式选择框,替你完成写配置这一步。
3分钟装好:/style 命令安装步骤
只需两步——先获取仓库,再把两类文件复制到对应目录:
# 1. 获取仓库
git clone https://gitcode.com/gh_mirrors/at/attention-span
# 2. 复制风格文件和 /style 命令
mkdir -p ~/.claude/output-styles ~/.claude/commands
cp attention-span/output-styles/*.md ~/.claude/output-styles/
cp attention-span/commands/style.md ~/.claude/commands/
💡 只想在单个项目里用?把风格文件放进该项目的
.claude/output-styles/即可,/style 会自动识别项目级风格。
完成后,在 Claude Code 会话里直接输入 /style,弹窗就会出现。
命令速查:/style 的 4 种用法
| 命令 | 效果 |
|---|---|
/style |
弹窗列出所有已安装风格,点选即可 |
/style spartan |
直接启用 Spartan 风格(大小写不敏感) |
/style default |
恢复内置风格(none、off 也可以) |
/style 不存在的名字 |
提示无匹配,并列出所有合法风格名 |
几个值得了解的细节(来自命令定义 commands/style.md):
- 📂 两级查找:同时扫描全局
~/.claude/output-styles/*.md和项目.claude/output-styles/*.md;同名风格出现时项目级优先,与 Claude Code 自身的优先级一致; - 📝 精准写入:全局风格写入
~/.claude/settings.json,项目风格写入.claude/settings.local.json,个人偏好不会被误提交到队友的检出目录; - ⏱️ 下次请求生效:切换后若没立刻变化,执行一次
/clear或重启会话即可。
幕后机制:它比手改安全在哪
有人可能觉得“不就是写几行 JSON 吗”。实际上 commands/style.md 里的规则相当讲究:
- 把配置当 JSON 而非文本行:先读取并解析,改的是结构体再写回。基于行的编辑会损坏单键文件或压缩格式的文件;
- 恢复默认是“删键”而不是“留空”:选 Default 时会从两个 settings 文件中同时移除
outputStyle键;删完变空对象就写入{},因为空文件是非法 JSON,Claude Code 会拒绝加载; - 最小改动:只动
outputStyle这一个键,文件里其他配置原样保留; - 工具白名单 + 禁止模型自触发:frontmatter(commands/style.md)声明了
allowed-tools: Glob, Read, Write, Edit, AskUserQuestion和disable-model-invocation: true——只用最小必要的工具,且只有人能敲这个命令,AI 不会自己触发它。
三个内置输出风格:怎么选
output-styles/ 目录下的风格都是单个 markdown 文件,可读、可改、可自建:
| 风格 | 文件 | 适合谁 |
|---|---|---|
| Attention-kind | attention-kind.md | 结论先行、大白话,给看腻了长篇大论的人 |
| Spartan | spartan.md | 极致精简、零客套,适合埋头干活 |
| Rundown | rundown.md | TL;DR + ✅/🟡/⬜ 清单,适合站会和进度汇报 |
风格不只是“说得少”。官方 benchmark 报告 的实测:输出平均短约 43%,而编码任务通过率保持不变(开/关风格均为 97%)——工程能力没动,只是表达变了。
常见问题:/style 命令 FAQ
Q:/style 弹窗里没有任何风格?
A:多半是只装了命令、没装风格文件。先把 output-styles/*.md 放进上面说的目录,再执行 /style。
Q:切换后输出没变化?
A:新风格从下一次请求生效;仍不生效就 /clear 或重启会话。
Q:会影响 subagent 吗? A:风格只作用于主对话,子代理(subagents)运行的是自己的提示词。
Q:会改变 AI 的编码行为吗?
A:不会。所有风格都声明了 keep-coding-instructions: true(见 output-styles/attention-kind.md),只改说话方式。
Q:怎么查看本地装的版本号?
A:每个风格文件里都带版本标记,执行 grep attention-span ~/.claude/output-styles/*.md,与 VERSION 和 CHANGELOG.md 对比即可判断是否落后。
总结
/style 命令的价值一句话概括:把“切换输出风格”从一次配置修改变成一个动作。新手只需记住三条:/style 看弹窗,/style spartan 直接选,/style default 恢复原状。attention-span 让 AI 说人话,而 /style 让这个开关真正一触即发。


