你请 Verboo Code 修一个问题，它直接交回写好的代码，不解释为什么这样写。有时这正是你想要的。有时你想弄懂原因，或者希望智能体停下来，让你自己写最难的那部分。输出风格（output style）改变的就是这一点：编程智能体和你沟通的方式，而不改变它会做的事。
/output-style 去哪了？
它已被弃用。在 Verboo Code 中输入 /output-style，会看到这条消息：
/output-style has been deprecated. Use /config to change your output style, or set it in your settings file. Changes take effect on the next session.输出风格仍然存在，只是选择的位置变了：现在通过 /config 或设置文件来选，更改从下一个会话起生效。
内置了哪些输出风格？
三种。默认风格，加上两种边工作边学习的风格：
| 风格 | 回答有什么变化 | 适合 |
|---|---|---|
Default | 高效完成任务，回答简洁 | 日常工作 |
Explanatory | 在写代码前后加入 ★ Insight 区块，用 2 到 3 点说明实现选择和项目中的模式 | 上手陌生的代码库 |
Learning | 包含 Explanatory 的全部内容；当任务超过 20 行且涉及设计决策时，会在代码中留下 TODO(human)，请你写 2 到 10 行 | 动手练习 |
在 Learning 风格下，智能体发出 Learn by Doing 请求后会停下，等你实现完再继续。如果你只想把任务做完，就别用它。
怎样用 /config 切换输出风格？
在会话中输入：
/config选择 Output style，会打开 Preferred output style 面板，列出三种内置风格和你自己创建的风格。选一个，然后退出 /config。
选择会以 outputStyle 键写入项目目录下的 .verboo/settings.local.json。关闭当前会话，再开一个新的：
verboo从这个会话开始，智能体就按新风格回答。
能直接在设置文件里指定风格吗？
可以。键是 outputStyle，值是风格名称：
{
"outputStyle": "Explanatory"
}写在哪个文件，决定了谁会用上这个风格：
| 文件 | 作用范围 |
|---|---|
~/.verboo/settings.json | 你自己，所有项目 |
.verboo/settings.json | 所有克隆该仓库的人（会提交到 git） |
.verboo/settings.local.json | 你自己，仅当前项目（/config 写入的位置） |
要恢复默认，使用 "outputStyle": "default" 或删除这个键。
陷阱：名称必须完全一致，区分大小写。"outputStyle": "explanatory" 找不到 Explanatory 风格，而且 Verboo Code 不会提示，会静默回到默认风格。如果风格没有生效，先检查拼写。
怎样创建自己的输出风格？
每个风格一个 Markdown 文件，放在 output-styles 目录中。文件内容就是这个风格的指令。下面这个风格要求智能体在修改前先说明风险：
mkdir -p .verboo/output-styles文件 .verboo/output-styles/revisor.md：
---
name: Revisor
description: 修改前指出每处改动的风险，回答简短
keep-coding-instructions: true
---
# Revisor 风格
- 修改任何文件前，用最多 3 条列出要改什么以及每处改动的风险。
- 用简短的句子回答，不要重复刚写好的代码。
- 完成后，说明运行哪个测试命令来验证改动。打开 /config，Revisor 已经出现在列表中，并带有你写的描述。frontmatter 的三个字段：
| 字段 | 不填写时 |
|---|---|
name | 使用去掉 .md 的文件名（revisor） |
description | 从文件内容中提取描述 |
keep-coding-instructions | 保持关闭（见下一节） |
outputStyle 填的是 name，不是文件名。按上面的例子，值是 "Revisor"。
为什么用了我的风格后，智能体不好好写代码了？
因为 frontmatter 里缺少 keep-coding-instructions: true。没有这个字段时，自定义风格会把系统提示词中关于如何执行编程任务的部分去掉，智能体只按你的风格行事。
内置的 Explanatory 和 Learning 已默认开启该字段，所以保留了编程行为。你自己的风格不会默认开启：如果这个风格用于写代码，就写上这个字段。只有当你想让智能体做别的事，比如写文档或回答问题时，才适合不写。
Verboo Code 在哪里查找风格？
| 目录 | 范围 |
|---|---|
~/.verboo/output-styles/ | 你自己的，所有项目 |
.verboo/output-styles/ 或 .claude/output-styles/ | 项目的。从当前目录向上查找，直到 git 仓库根目录 |
.claude/output-styles/ 也会被读取，所以你已放在那里的项目风格无需复制即可使用。但用户目录只有 ~/.verboo/output-styles/：放在 ~/.claude/output-styles/ 的风格不会出现。如果你用 VERBOO_CONFIG_DIR 改了配置目录，用户目录就变为 $VERBOO_CONFIG_DIR/output-styles/。
两个风格同名时，范围更具体的胜出：项目的覆盖你的，你的覆盖内置的。项目中一个 name: Explanatory 的 Explanatory.md，会为所有在该项目中工作的人替换内置风格。
输出风格还是 AGENTS.md：用哪个？
两者改变的东西不同：
| 输出风格 | AGENTS.md / /memory | |
|---|---|---|
| 改变 | 智能体怎么沟通：长度、格式、是否解释、是否请你动手 | 智能体对项目的了解：命令、约定、文件位置 |
| 一次只能一个？ | 是，只有一个风格生效 | 否，多个文件会叠加 |
"说完成之前先运行 pnpm test"是项目规则，应写进 AGENTS.md，参见用 /memory 设置永久指令的教程。"用要点回答并说明风险"是沟通方式，应写进输出风格。
Explanatory 和 Learning 会让回答更长、来回更多。在 Verboo Code 上 token 不限量，多出来的解释不会变成多出来的账单。
已于 2026-11-04 在 Verboo Code 源码（verbeux-ai/code，v0.15.41）中核实：src/commands/output-style、src/constants/outputStyles.ts、src/outputStyles/loadOutputStylesDir.ts、src/constants/prompts.ts、src/components/Settings/Config.tsx 与 src/utils/markdownConfigLoader.ts。
