为什么自定义风格在长会话中会褪色:拆解pohuy的Per-Turn Hook机制style-reminder.sh

原创2026-10-12 09:58:491,683 阅读

为什么自定义风格在长会话中会褪色:拆解pohuy的Per-Turn Hook机制style-reminder.sh

pohuy 是一个让 AI 编程代理(Claude Code、Codex CLI 等)换上"二十年老码农"口吻说话的开源风格扩展。它最容易被忽略、也最见功力的一环,是解决自定义风格在长会话中褪色的问题——靠的是一行"每轮提醒"的 Hook 机制,核心脚本只有 32 行:style-reminder.sh。这篇文章把这套 Per-Turn Hook 机制完整拆给你看。

pohuy自定义风格AI代理扩展项目主视觉图

长会话中,自定义风格为什么会"褪色"

用 AI 代理写过长任务的朋友大概都遇到过:会话开头,代理的语气、风格非常对味;聊到三四十轮之后,它慢慢"变回默认了"——该短的句子变长了,该直接的地方开始客套。风格没有失效,而是注意力被稀释了。

原因藏在 Claude Code 的内部机制里,style-reminder.sh 的文件头注释解释得很直白:

  • 内置风格(Proactive、Explanatory、Learning):harness 每轮都会自动注入一行提醒,比如 Proactive output style is active. Remember to follow the specific guidelines for this style.
  • 自定义风格:风格说明只在会话开始时写进 system prompt 一次,此后再无任何强化。上下文越长,这"一次性指令"的权重越低。
对比项 内置风格 自定义风格(默认行为)
风格说明注入时机 system prompt(一次) system prompt(一次)
每轮风格提醒 ✅ harness 自动注入 ❌ 没有
长会话表现 稳定 逐渐褪色回默认语气

问题的本质是一句话:自定义风格缺了内置风格才有的"每轮强化"。

pohuy 的解法:给自定义风格补上每轮提醒

pohuy 的思路不是重写 harness,而是"伪装"——README 原话是:让 harness 把 Pohuy 当成内置风格来对待。

具体做法:

  1. 监听 UserPromptSubmit 事件——用户每提交一轮 prompt,harness 就会执行一次注册的 Hook;
  2. Hook 检查当前激活的是哪个 output style;
  3. 如果是自定义风格,就逐字输出与内置风格完全相同的那行提醒。

这样每一轮对话,代理都会重新收到"Pohuy output style is active…"的信号,风格权重被持续刷新。

pohuy自定义风格词根经济性KORNI-BENCH对比柱状图

顺便一提,pohuy 风格本身极其激进:用 4 个词根加前缀后缀生成整个"词库"(上图 KORNI-BENCH 对比)。风格压缩得越狠,越依赖每轮提醒来维持稳定——这正是这个 Hook 存在的意义。

逐行拆解 style-reminder.sh:30 行脚本的完整逻辑

整个脚本分三步,干净利落。

第一步:读取当前激活的 outputStyle

style-reminder.sh#L14-L25 从 ~/.claude/settings.json 里取出 outputStyle 字段的值:优先用 python3 解析 JSON(最可靠),没有 python3 就退回 sed 正则提取——保证在最小环境里也能跑。

第二步:内置风格直接跳过

style-reminder.sh#L27-L30 用一个 case 判断:如果当前是 default、Proactive、Explanatory、Learning 或空值,直接 exit 0。这些风格本来就有 harness 自带的提醒,重复注入反而画蛇添足。

第三步:输出一行"同款"提醒

最后只剩一行核心逻辑:

echo "$style output style is active. Remember to follow the specific guidelines for this style."

注意措辞与内置风格的提醒一字不差——harness 无法区分这行提醒来自哪里,于是 Pohuy 获得了和内置风格同等的"每轮待遇"。

注册 UserPromptSubmit Hook 的最快方法

Hook 写好了,还得注册才生效。两种路径:

一键安装(推荐)

克隆仓库后运行安装脚本 install.sh:

git clone https://gitcode.com/gh_mirrors/po/pohuy
cd pohuy
./install.sh

它会自动完成四件事:把风格文件 output-styles/pohuy.md 和完整技能(SKILL.md 加四个 references 词典)放进 ~/.claude/,把 style-reminder.sh 放进 ~/.claude/hooks/,再往 settings.json 写入 "outputStyle": "Pohuy" 并幂等注册 Hook。重启会话即可生效。

手动注册(看懂机制用)

如果你已经装好了风格,只想补上 Hook,等价的手动步骤是:

  1. 将 hooks/style-reminder.sh 复制到 ~/.claude/hooks/;
  2. 在 ~/.claude/settings.json 中注册:
{
  "outputStyle": "Pohuy",
  "hooks": {
    "UserPromptSubmit": [
      { "hooks": [ { "type": "command", "command": "~/.claude/hooks/style-reminder.sh" } ] }
    ]
  }
}
  1. 重启 Claude Code。

Codex CLI 同款机制:hooks.json 里的提醒行

install-codex.sh 把同一套思路搬到了 OpenAI Codex CLI:

  • 风格说明写进 ~/.codex/AGENTS.md(每轮会话都会加载);
  • 在 ~/.codex/hooks.json 注册 UserPromptSubmit Hook,每轮注入 Pohuy style is active... 提醒;
  • 如果 Hook 不生效,在 ~/.codex/config.toml 的 [features] 里加上 codex_hooks = true;
  • 想让内置性格不跟 Pohuy"抢话筒",可顺手设置 personality = "none"。

一个 Hook 机制,两套 CLI 通吃——这就是 Per-Turn 提醒方案的通用性所在。

效果验证:风格稳定到会话结尾

项目方给出的数据(见 README):在 SWE-Bench Pro 长会话任务中,Fable + pohuy 组合取得 80.3% 成功率,而单独 Fable 只有 69.2%。

pohuy风格加持下SWE-Bench Pro长会话解题成功率对比图

风格看似只是"说话方式",但在长会话里,稳定的语气压缩了无效措辞、保持了输出节奏——风格不掉线,任务表现才不掉线。

关键文件导航

想深入源码,从这几个入口开始:

小结:自定义风格褪色不是模型"忘性大",而是机制上缺了每轮强化。pohuy 用 32 行 Shell 脚本补上这一环,让风格在第 100 轮依旧稳定——这个"Per-Turn 提醒"的思路,对任何想给 AI 代理定制风格的场景都通用。

登录后查看全文
pohuy