为什么自定义风格在长会话中会褪色:拆解pohuy的Per-Turn Hook机制style-reminder.sh
为什么自定义风格在长会话中会褪色:拆解pohuy的Per-Turn Hook机制style-reminder.sh
pohuy 是一个让 AI 编程代理(Claude Code、Codex CLI 等)换上"二十年老码农"口吻说话的开源风格扩展。它最容易被忽略、也最见功力的一环,是解决自定义风格在长会话中褪色的问题——靠的是一行"每轮提醒"的 Hook 机制,核心脚本只有 32 行:style-reminder.sh。这篇文章把这套 Per-Turn Hook 机制完整拆给你看。
长会话中,自定义风格为什么会"褪色"
用 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 当成内置风格来对待。
具体做法:
- 监听
UserPromptSubmit事件——用户每提交一轮 prompt,harness 就会执行一次注册的 Hook; - Hook 检查当前激活的是哪个 output style;
- 如果是自定义风格,就逐字输出与内置风格完全相同的那行提醒。
这样每一轮对话,代理都会重新收到"Pohuy output style is active…"的信号,风格权重被持续刷新。
顺便一提,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,等价的手动步骤是:
- 将 hooks/style-reminder.sh 复制到
~/.claude/hooks/; - 在
~/.claude/settings.json中注册:
{
"outputStyle": "Pohuy",
"hooks": {
"UserPromptSubmit": [
{ "hooks": [ { "type": "command", "command": "~/.claude/hooks/style-reminder.sh" } ] }
]
}
}
- 重启 Claude Code。
Codex CLI 同款机制:hooks.json 里的提醒行
install-codex.sh 把同一套思路搬到了 OpenAI Codex CLI:
- 风格说明写进
~/.codex/AGENTS.md(每轮会话都会加载); - 在
~/.codex/hooks.json注册UserPromptSubmitHook,每轮注入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%。
风格看似只是"说话方式",但在长会话里,稳定的语气压缩了无效措辞、保持了输出节奏——风格不掉线,任务表现才不掉线。
关键文件导航
想深入源码,从这几个入口开始:
- Hook 本体:hooks/style-reminder.sh
- Claude Code 一键安装:install.sh
- Codex CLI 安装/卸载:install-codex.sh
- 风格定义(完整规则与状态量表):output-styles/pohuy.md
- 技能核心与词典:skills/pohuy/SKILL.md、skills/pohuy/references/
- Pi 扩展实现细节:extensions/README.md
小结:自定义风格褪色不是模型"忘性大",而是机制上缺了每轮强化。pohuy 用 32 行 Shell 脚本补上这一环,让风格在第 100 轮依旧稳定——这个"Per-Turn 提醒"的思路,对任何想给 AI 代理定制风格的场景都通用。


