拆解attention-span风格文件源码:10条提示词规则如何让AI先给答案、再展开细节

原创2026-10-11 17:34:521,450 阅读

拆解attention-span风格文件源码:10条提示词规则如何让AI先给答案、再展开细节

attention-span 是一个专为 Claude Code、Codex 等 AI 编程助手设计的开源输出风格(output styles)项目。它不改变 AI 写代码的能力,只改变 AI"说话"的方式:每个风格就是一个 Markdown 提示词文件,放进 output-styles/ 目录后,AI 就会先给答案、再展开细节,输出更短、更易扫读。本文带你看懂这些风格文件的源码结构和 10 条核心提示词规则的写法。

attention-span项目吉祥物:一只用激光笔指挥AI输出简洁答案的猫

项目结构速览:一个风格就是一个 Markdown 文件

整个仓库非常小,核心就三部分:

三个风格的定位如下(摘自 README.md):

风格 文件 适合场景
Attention-kind attention-kind.md ADHD、注意力疲劳、受够了文字墙
Spartan spartan.md 极简信号流,零寒暄,专注干活
Rundown rundown.md 简报、站会、进度更新(TL;DR + 清单)

Spartan风格:戴斯巴达头盔的猫,激光只点亮一行重点

attention-kind.md 源码拆解:先给答案的 10 条规则

打开 output-styles/attention-kind.md,全文只有 50 多行,分为"文件头 + 角色设定 + 规则"三层,逐层看:

第一层:YAML 文件头(第 1-5 行)

文件开头是一个 YAML frontmatter,只有三行关键信息:

name: Attention-kind
description: ADHD-friendly. Plain English, front-loaded answers...
keep-coding-instructions: true
  • name / description:给 Claude Code 的 /config 选择器读的名字和描述;
  • keep-coding-instructions: true:关键设计——明确声明"只改说话方式,不动编码指令",保证 AI 干活质量不受影响。

紧接着是一个 <!-- body-start --> 标记(第 7 行),它是给 Codex、Devin 等其他 AI 用的:其他工具不认识 YAML 头,安装时一条 sed 命令从这个标记处截掉,就能拿到纯净的规则正文。

第二层:角色设定——不是限字数,而是"护注意力"

很多提示词会写"回复不超过 100 字",attention-span 反其道而行。文件第 9 行开头就是:

You are talking to a real human being with a limited attention span, not another LLM.(你在和一个注意力有限的人说话,不是另一个 LLM。)

它先定义了两种"致命失败"(attention-kind.md):

  • 漏掉关键信息——读者拿不到能行动的东西;
  • 把关键信息埋得太深——读者注意力耗尽前根本读不到。

这个"保护注意力"的框架,比硬性字数限制更能让 AI 在长会话里保持简短。CHANGELOG 记录显示,正是这次重构让长会话中的回复缩短了约 30%,而编码任务通过率保持 100%。详见 CHANGELOG.md。

第三层:10 条"先给答案"规则逐条解读

1️⃣ 第一句话就是结论

Lead with the bottom line, in one sentence.

第一句必须承载整篇回复最重要的信息,只读第一句的人也要拿到答案。不是"情况是这样的",而是真正的要点。

2️⃣ 说"能完整回答的最少内容",然后停

注意原文强调的不是"最少",而是"能完整回答的最少"——内部可以想多久都行,但回复要克制。铺垫、清嗓子、对短回复的二次总结都是浪费。

3️⃣ 内容太多时:先给最重要的,其余"报菜名"等用户点

给出最关键的一两条完整信息,然后点名其余内容并询问要不要展开("还有 3 块:Kestrel、SSO 队列、支持号码,要看吗?")。既不一次倾倒,也不静默丢弃。

4️⃣ 用户明确要求深入时,简短规则当场失效

一旦用户说"仔细讲讲""带我走一遍",本次回复的简洁规则全部暂停:给出每个决策、数字、条件和风险。这条规则避免了"用户想要长答案却被压成短答案"的翻车。

5️⃣ 数字、阈值、限定条件是"要点",不是"细节"

"工作区不满 14 天的缓冲改为 30 秒"是事实,"新工作区缓冲更短"就是错误的事实。绝不把"仅限 X 场景"放宽成"所有场景",绝不丢掉让结论可执行的数字。

6️⃣ 警告最后才允许被删,永远不先删

风险、前提、正确性相关的细节必须跟着它所保护的要点走,绝不压缩、绝不延后——漏掉警告正是"让读者做错决定"的失败。

7️⃣ 只展开"砍掉会让用户犯错"的内容

每次展开先说"为什么重要"。如果砍掉某一行不会损失任何东西,那就砍,那是把注意力还给用户。

8️⃣ 交付物纯净(Deliverable purity)

用户让你"产出一个东西"(邮件、commit message、代码片段)时,只输出那个东西本身,前后不包一层"这是一份草稿:……需要调整告诉我"。基准测试里,交付物干净输出率从 12% 提升到 88%。

9️⃣ 大白话、每点一个论点、不重复

用"聪明朋友会用的词";无法避免的技术术语最多 5 个字内注释一次;结尾不许复述答案。

🔟 为"扫读"而生的格式

  • 每个要点用 → 开头、独立成段,段间留空行(终端会把紧凑列表挤成一团,所以不用 - 列表);
  • 加粗单独就能承载整个答案:只读加粗部分也能拿到要点、建议和警告;
  • 一个块一个想法,一整段无空行的文字被视为 bug。

这套格式的直接效果:AI 回复里"第一个加粗要点前平均 40 词"变成"约 6 词",答案出现在第一行的比例从 3% 升到 75%(见 benchmarks/results/2026-08-11-benchmark.md)。

Rundown风格:戴发带的猫冲过纸片,激光点亮清单上的勾选项

另两个风格文件的差异:规则骨架相同,语气不同

Spartan 和 Rundown 与 Attention-kind 共享同一套"骨架":先给答案、保护数字与警告、交付物纯净、→ 箭头 + 加粗扫读格式。区别只在语气与形态:

  • spartan.md:把温度全部去掉。陈述式、命令式,无过渡句、无缓冲语,"每个字都要挣得自己存在的位置"。适合埋头干活时只要信号、不要对话。
  • rundown.md:以 TL;DR: 开头一行定调,状态用 ✅ / 🟡 / ⬜ 清单呈现,下一步选项各配一个 emoji。它优化的是可读性与扫读性而非简短,还内置了一条"严禁编造状态"的护栏(没给的状态标 ⬜,不许脑补)。

三个文件各只有 20-50 行,是学习"如何给 AI 写行为规则提示词"的极佳范本:先定义失败模式,再给可执行规则,最后给格式约束。

效果有数据背书:基准测试怎么验证

项目没有靠感觉说话,benchmarks/ 提供了可复现的 A/B 测试(同一模型、只变风格这一个变量,且不使用 LLM 打分):

  • 工作质量不变:12 个带隐藏测试的编码任务,风格开关通过率同为 97%;
  • 输出平均缩短约 43%:啰嗦型回答缩短 50%-71%,本来就短的回答几乎不动;
  • 交付物干净率 88%(无风格时仅 12%)。

完整数据与运行脚本见 benchmarks/results/2026-08-11-benchmark.md 和 benchmarks/harness/scannability.py。

快速上手:三步装好 attention-span

  1. 把风格文件放进 ~/.claude/output-styles/(全局)或项目内 .claude/output-styles/;
  2. 在 ~/.claude/settings.json 加一行:{ "outputStyle": "Attention-kind" };
  3. 重启或执行 /clear 即可。

不想手改 JSON?安装 commands/style.md 提供的 /style 命令,弹窗选择即可,/style default 还能一键切回内置风格。成本方面:风格正文约 650 tokens,每个会话只加一次且会被缓存,几轮回复内就被输出端的节省覆盖。

小结:attention-span 的精髓不是"限字数",而是把提示词的目标从"回复多长"重新定义为"用户能带走多少"。10 条规则围绕"第一句给结论、警告永不删、数字不许圆、格式为扫读而生"展开,短小、可读、可移植——下次你想让 AI 闭嘴干活、开口给重点时,这三个文件值得直接抄作业。

登录后查看全文
attention-span