
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 AI 助手没有“坏记性”。它们有 。 糟糕的治理 你见过这种情况： 
 
 
 
 你写了一份详细的架构指南。模型却忽略了它。 你说“4层架构”。它却输出了3层。 你说“不要 ”。它却像施舍一样删除了 。 el-input <el-input v-model="value" /> 这与智能无关。这关乎激励。 在 Claude Code 中， ，而不是硬性约束。如果 Claude “认为”它可以在不调用技能的情况下回答，它就会这样做。而 。 技能是可用的上下文 你的项目手册就成了装饰品 在我们的团队中，使用 Claude Code 构建 RuoYi-Plus 代码库时，我们对此进行了追踪： 
 
 在没有干预的情况下，Claude 主动激活项目技能的频率仅为约 25%。 所以，四分之三次，“规则”都不是规则。它们只是建议。 我们想要更严格的东西：一种机制，让 Claude 的行为不像一个聪明的实习生，而更像一个在写代码前会先阅读手册的资深工程师。 解决方案不是更多的提示。 解决方案是 。 钩子 (Hooks) 经过大约 1 个月的迭代，我们发布了一个   配置堆栈： .claude 
 
 
 
 
 （治理） 4 个生命周期钩子 （知识） 26 个领域技能 （流程编排） 斜杠命令 （并行专家） 代理 (agents) 结果： 
 
  减少了违反规则的代码，减少了“请重做”的循环，并大大减少了有风险的工具操作。 开发任务的技能激活率：约 25% → 90%+ 本文将分解架构，以便你可以在自己的仓库中复现它。 1) 为什么 Claude Code “会忘记”：技能默认是可选的 Claude Code 的默认流程如下所示： 用户提示 → Claude 回答（可能调用技能，也可能不调用）
 那个“可能”就是问题所在。 Claude 的内部决策启发式通常是： 
 
 
 “我能否在无需额外上下文的情况下快速回答？” 而不是“我*必须*遵守仓库规则吗？” 因此，系统会趋向于便利性。 你想要的是 ：一个轻量级的“控制平面”，在 Claude 开始推理*之前*运行，并塑造每次的工作。 制度化摩擦 2) 突破：强制技能评估钩子 我们在最早的时刻实现了一个钩子： 。 UserPromptSubmit 它会打印一个简短的策略块，Claude 在*做任何事情之前*都会看到它： 
 
 
 
 评估每个技能：是/否 + 原因 如果有“是”：立即调用技能 然后才：继续执行实现 “强制评估”钩子（核心逻辑） 我们故意保持其简单和确定性： 
 
 
 检测斜杠命令（逃生舱口） 否则打印评估协议 // .claude/hooks/skill-forced-eval.js (核心思想，简化版)
const prompt = process.env.CLAUDE_USER_PROMPT ?? "";
​
// 逃生舱口：如果用户调用了斜杠命令，则跳过强制评估
const isSlash = /^\/[^\s/]+/.test(prompt.trim());
if (isSlash) process.exit(0);
​
const skills = [
  "crud-development",
  "api-development",
  "database-ops",
  "ui-pc",
  "ui-mobile",
  // ... 继续（我们有 26 个）
];
​
const instructions = [
  "## 强制技能激活协议 (必须遵守)",
  "",
  "### 步骤 1 — 评估",
  "对于每个技能，输出：[技能] — 是/否 — 原因",
  "",
  "### 步骤 2 — 激活",
  "如果任何一个技能是“是”→ 立即调用 Skill(<名称>)。",
  "如果所有技能都是“否”→ 声明“无需技能”并继续。",
  "",
  "### 步骤 3 — 实现",
  "在完成步骤 2 后，才开始实际解决方案。",
  "",
  "可用技能:",
  ...skills.map(s => `- ${s}`)
].join("\n");
​
console.log(instructions);
 实际情况如何变化 之前（无钩子）： 
 
 “构建优惠券管理系统。” Claude 开始编码… 却忽略了你的 4 层架构或禁止使用的组件。 之后（强制评估钩子）： Claude 必须首先生成一个明确的决策表，然后激活技能，然后实现。 行为的转变是巨大的，因为你消除了“可选合规”。 3) 为什么是 90% 而不是 100%？ 因为我们有意添加了一个 。 快速通道 当用户知道他们想要什么时，输入类似这样的命令： 
 
 
 
 /dev build coupon management /crud b_coupon /check 应该瞬间完成。因此，钩子会跳过对斜杠命令的评估，让命令工作流接管。 这就是权衡： 
 
 
 对自由格式提示的治理 对结构化命令的速度 4) 钩子作为生命周期控制平面（4 个钩子堆栈） 将钩子想象成代理会话的 CI 流水线——只不过它实时在你的终端中运行。 我们使用了四个关键点： 4.1 SessionStart：“在你说话之前看看仓库” 当会话开始时，我们展示： 
 
 
 
 
 当前 git 分支 未提交的更改 待办事项 (TODO) / 状态 常用命令 示例输出： 🚀 会话开始：RuoYi-Plus-Uniapp
时间：2026-02-16 21:14
分支：master
​
⚠️ 未提交的更改：5 个文件
📋 TODO：3 个未完成 / 12 个已完成
​
快捷方式：
  /dev    构建功能
  /crud   生成模块
  /check  验证约定
  Claude 不会再像进入一个空房间那样行事。 重要性： 4.2 UserPromptSubmit：强制技能评估（纪律） 这是“必须阅读手册”的门禁。 4.3 PreToolUse：安全层（工具治理） Claude Code 很强大，因为它能运行工具：Bash、写入文件、编辑代码。 这也可能是发生事故的方式。 PreToolUse 是你在执行不可逆操作之前的最后一道防线。 我们阻止了一个小的黑名单（并对更广泛的灰名单发出警告）： // .claude/hooks/pre-tool-use.js (概念性)
const cmd = process.env.CLAUDE_TOOL_INPUT ?? "";
​
const hardBlock = [
  /rm\s+(-rf|--recursive).*\s+\//i,
  /drop\s+(database|table)\b/i,
  />\s*\/dev\/sd[a-z]\b/i,
];
​
if (hardBlock.some(p => p.test(cmd))) {
  console.log(JSON.stringify({
    decision: "block",
    reason: "检测到危险命令模式"
  }));
  process.exit(0);
}
​
// 可选：对敏感操作（批量删除、chmod -R 等）发出警告/确认
 这不是多疑。我们曾见过模型在错误的目录中用   “清理临时文件”。你需要一个不会依赖模型谨慎的保护机制。 rm -rf 4.4 Stop：“闭环”并提供下一步指导 当 Claude 完成时，我们： 
 
 
 
 总结文件更改（新增 vs 修改） 建议下一步操作（运行测试、更新文档、提交） 可选地触发代理（代码审查） 示例： ✅ 完成 — 8 个文件已更改
​
下一步：
- @code-reviewer 进行后端约定检查
- SQL 已更改：同步迁移脚本
- 考虑：git commit -m "feat: 优惠券模块"
 目标：消除“聊天中可行”的差距。 5) 技能：你可以真正强制执行的知识层 一旦激活变得确定，技能就变成了它们应有的样子：一个 。 特定领域的知识库 我们在以下领域构建了 26 个技能： 
 
 
 
 
 
 
 后端（CRUD、API、DB、注解、错误处理） 前端（PC 组件策略、状态管理） 移动端（UI 工具包、uniapp 平台约束） 集成（支付、微信、OSS） 质量（性能、安全、bug 检测） 工程管理（架构、git 工作流、技术决策） 可扩展的技能文件结构 每个   都遵循相同的骨架： SKILL.md # 技能名称
​
## 何时触发
- 关键词：
- 场景：
​
## 核心规则
### 规则 1
解释 + 示例
​
### 规则 2
解释 + 示例
​
## 禁止项
- ❌ ...
​
## 参考代码
- path/to/file
​
## 清单
- [ ] ...
 这种一致性很重要，因为模型学会了如何 技能。 消费 6) 命令：工作流，而非建议 技能解决“什么才是正确的”。 命令解决“什么是流程”。 6.1  ：一个 7 步开发流程 /dev 我们将   设计为一个有主见的流程： /dev 
 
 
 
 
 
 
 
 明确需求 设计（API + 模块 + 权限） 数据库设计（SQL + 字典 + 菜单） 后端（4 层输出） 前端（组件策略 + 路由） 测试/验证 文档/进度更新 它本质上是：“资深人士希望初级人士如何工作”的编码，作为一个可运行的脚本。 6.2  ：从表格生成一个完整的模块 /crud 输入： /crud b_coupon
 输出（示例集）： 
 
 
 
 
 
 实体/BO/VO DAO + 查询包装器规则 服务 + 控制器（无禁止模式） Mapper 前端 API + 页面脚手架 手动工作：  命令驱动： （加上审查） 2–4 小时 5–10 分钟 6.3  ：全栈约定 linting（人类可读） /check 这是我们将技能转化为验证器的部分： 
 
 
 
 后端：分层规则、禁止的继承、查询包装器策略 前端：禁止的组件、包装器使用 移动端：组件工具包、单位、导入 7) 代理：并行专家（不要使主线程过载） 有些任务应由专用子代理处理： 
 
 
 ：带有严格清单的约定检查 @code-reviewer ：更新状态文档、待办事项、进度指标 @project-manager 优势不是“更多的智能”。而是 和主会话中减少的上下文污染。 关注点分离 一个实用的模式： 
 
 
 
 
 主代理生成代码 Stop 钩子建议审查 你调用  @code-reviewer 审稿人返回结构化的 diff + 修复列表 8) 整个系统：治理 + 知识 + 流程 + 分工 这是架构的单句话概括： 
 
 钩子强制执行行为，技能提供标准，命令编码工作流，代理处理并行专业知识。 是的——这就是如何将一个“通用 AI 助手”变成一个“仓库原生队友”。 9) 最小可复现设置（易于复制粘贴） 如果你想要最小但仍可运行的版本，请构建这个： .claude/
  settings.json
  hooks/
    skill-forced-eval.js
    pre-tool-use.js
  skills/
    crud-development/
      SKILL.md
 最小化的   (UserPromptSubmit 钩子) settings.json {
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/skill-forced-eval.js"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/pre-tool-use.js"
          }
        ]
      }
    ]
  }
}
 然后迭代： 
 
 
 
 
 
 添加 SessionStart 添加 Stop 仅在发现反复的“错误行为”时才扩展技能 将重复的工作流编码为命令 将审查/PM 任务卸载给代理 结束语：“能力”不是瓶颈—— 才是 激活 你的模型已经足够强大。 缺少的是一个 。 让正确行为自动发生的系统 一个聪明的新员工如果没有手册，就会自由发挥。一个聪明的新员工有了： 
 
 
 
 
 强制执行的清单 明确的禁止模式 可复现的工作流 用于审查和 PM 的专家 ……就能很快变得一致。 Claude 也一样。

This story contains AI-generated text. The author has used AI either for research, to generate outlines, or write the text itself. 

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

如何为 Claude 代码构建具有钩子、技能和代理的治理层

About Author

註釋

標籤

这篇文章刊登在

Related Stories

HackerNoon Decoded: The Top 10 Countries Where HackerNoon Is the Most Active

Floki 的 Valhalla 成为印度环斯里兰卡赛事联合赞助商

成功云迁移的完整指南：策略和最佳实践

State of the Noonion: A New Era For Brands and Writers

HackerNoon Decoded: The Top 10 Countries Where HackerNoon Is the Most Active

Floki 的 Valhalla 成为印度环斯里兰卡赛事联合赞助商

成功云迁移的完整指南：策略和最佳实践

State of the Noonion: A New Era For Brands and Writers

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps