不再对 AI 说「帮我做这个」

用 Claude Code 时最常犯的错误是什么？指令模糊。你说「优化一下这段代码」，AI 猜你想改什么，结果往往不是你要的。

Claude Code Prompt Improver 是一个 UserPromptSubmit 钩子——在你发出指令后、Claude Code 执行前，自动评估你的 prompt 是否清晰。如果太模糊，它会追问 1–6 个问题来澄清，然后再执行。

Prompt Improver 演示

核心逻辑

  • 自动评估——Hook 拦截每条指令，判断清晰度
  • 追问澄清——模糊指令触发 1–6 个针对性问题，明确后再执行
  • 跳过机制——以 *、/、# 开头的指令直接跳过评估
  • 技能架构（v0.4+）——清晰指令零开销，模糊指令才加载 prompt-improver 技能
  • 工作流路由（v0.5.4）——根据关键词将规划路由到会话模型，实现路由到更便宜的模型
  • 研究调度——Glob、Grep、WebSearch 等通过独立的 Haiku 子 Agent 执行，节省主上下文 token

性能

每次 prompt 评估仅约 189 tokens，比 v0.3.x 版本减少 31%。清晰指令零开销。

安装

# 通过 Claude Code Marketplace 安装（推荐）
# 或手动添加到 ~/.claude/settings.json

要求 Claude Code 2.0.22+。

为什么值得用？

  • 省 token——减少因指令不清晰导致的无效对话轮次
  • 省时间——AI 不再猜你的意图，一次到位
  • 开源 MIT——代码完全开放，可以自定义评估逻辑

总结

Claude Code Prompt Improver 解决了一个很实际的问题：和 AI 沟通时指令不清导致的效率损耗。它像一个「提醒你说明白」的搭档，在每次对话开始前帮你把需求理清楚。如果你天天用 Claude Code，装上这个钩子能省不少来回扯皮的 token。

▶ 前往 GitHub 仓库 · 1,500 ★