/style命令深度解析:attention-span如何让切换AI输出风格不再手改settings.json

原创2026-10-11 17:29:241,328 阅读

/style命令深度解析:attention-span如何让切换AI输出风格不再手改settings.json

attention-span 是一个面向 Claude Code、Codex 等 AI 编程工具的开源输出风格包,它只改变 AI 与你“说话”的方式,而不改变它写代码的方式。其中自带的 /style 命令让你一键切换 AI 输出风格,不再需要手改 settings.json。本文带你彻底搞懂它的安装与用法。

attention-span 输出风格猫吉祥物

为什么需要 /style:手切风格的三个麻烦

开启输出风格的传统流程是分三步手动操作(见 README.md 的 Install 部分):

  1. 把风格文件放进 ~/.claude/output-styles/ 目录;
  2. 打开 ~/.claude/settings.json,手写一行 "outputStyle": "Attention-kind";
  3. 重启会话或执行 /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 不存在的名字 提示无匹配,并列出所有合法风格名

attention-span spartan 简洁输出风格演示猫

几个值得了解的细节(来自命令定义 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 + ✅/🟡/⬜ 清单,适合站会和进度汇报

attention-span rundown 简报风格猫

风格不只是“说得少”。官方 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 让这个开关真正一触即发。

登录后查看全文
attention-span