设计Agent 生成代码的 Lint 规则体系，理解 Hook 机制-云帆数科

上一章我们建立了一个关键认知：Rules 文件是概率性的约束——Agent "大概率"会遵守，但不保证。当你告诉 Agent “不要硬编码 API Key”，它在 99 次调用中可能都遵守了，但第 100 次可能因为上下文过长或注意力分散而忽略这条规则。在 In the Loop 模式中，人类审查是最后的安全网。但在 On the Loop 模式中，我们不希望依赖人类审查——我们希望有一个确定性的机制来自动拦截违规代码。这就是Hook的价值所在。Hook 是挂载在 Agent 生命周期事件上的确定性脚本——当 Agent 试图执行某个操作时，Hook 脚本会被触发，如果检查不通过，操作会被直接阻止，Agent 无法跳过。“Hooks guarantee execution; prompts do not.”—— blakecrosley.com, Agent Architecture Guide核心概念传统 Lint 与 Agent Lint 的区别传统的 Lint 工具（ESLint、Pylint、golangci-lint）是为人类开发者设计的——它们检查代码风格、潜在 Bug、未使用的变量等。当代码不合规时，Lint 会给出警告，但开发者可以选择忽略。Agent Lint 需要解决一类不同的问题：维度传统 LintAgent Lint检查对象人类写的代码AI 生成的代码关注重点代码风格、最佳实践安全、权限、架构边界执行方式开发者手动运行或 CI每次操作自动触发，不可跳过失败处理警告或错误exit code 2 直接阻止操作检查时机代码写完后代码写之前（PreToolUse）和写之后（PostToolUse）Agent Lint 的核心差异在于执行时机和不可跳过性：PreToolUse：在 Agent 执行工具（如 Bash、Write）之前检查——可以在代码生成之前就拦截危险操作不可跳过：exit code 2 会直接阻止操作，Agent 没有办法绕过Hook 架构：Agent 生命周期的 12+ 个事件Claude Code 定义了一组完整的生命周期事件，每个事件都可以挂载 Hook：Hook 事件触发时机能否阻止？最佳用途SessionStart会话开始否加载上下文、设置环境变量UserPromptSubmit用户发送消息是上下文注入、输入验证PreToolUse工具执行之前是安全阻止、自动审批PermissionRequest权限对话框出现是自动审批/拒绝PostToolUse工具成功执行后否*自动格式化、Lint、日志PostToolUseFailure工具执行失败后否错误处理SubagentStart子 Agent 启动否子 Agent 初始化SubagentStop子 Agent 结束是子 Agent 验证StopAgent 完成响应是任务完成验证PreCompact上下文压缩前否会话记录备份Setup–init/–maintenance否一次性设置SessionEnd会话结束否清理、日志记录*PostToolUse 可以向 Agent 提供反馈，但无法撤销已执行的操作。最核心的两个 Hook 是PreToolUse和PostToolUse：PreToolUse：在 Agent 执行操作之前运行检查脚本。如果脚本返回 exit code 2，操作被阻止，stderr 的内容会发送给 Agent 作为反馈。PostToolUse：在 Agent 成功执行操作之后运行处理脚本。常用于自动格式化、Lint 检查、审计日志。Exit Code：控制机制Hook 通过 exit code 与 Harness 运行时通信：Exit Code含义行为0成功Hook 正常运行，stdout 被处理2阻止操作被停止，stderr 发送给 Agent其他错误stderr 展示给用户，执行继续Exit code 2 是你的核心武器。一个返回 exit code 2 的 PreToolUse Hook 可以阻止任何危险操作。一个返回 exit code 2 的 Stop Hook 可以强制 Agent 继续工作。原理剖析Hook 配置结构Hook 在.claude/settings.json中配置：{"hooks":{"PreToolUse"

企业数字化 ERP 产品动态

相关推荐

AI 应用的隐形电费：为什么你的应用贵在 Token，而不是模型

写在前面：Token 不是一个小数点后的计费细节很多团队第一次做 AI 应用，最关心的问题通常是： 用哪个模型？ 模型单价是多少？ 回答质量够不够？ 上下文窗口有多大？这些问题当然重要，但真… · 2026/9/24 6:36:20

多模型底层调度实测拆解：智能择优匹配全品类开发任务

做开发这么久，你有没有过这种困惑？写后端复杂业务逻辑时调用某款模型，代码漏洞一堆；整理上万行存量项目代码又换一个模型，上下文直接超限；需要截图解析前端界面时再切另一款，来回切换账号、复制… · 2026/9/25 15:29:54

基于SSM实现的员工管理系统基于SSM的物业管理系统基于SSM的网上书城管理系统基于SSM的线上垃圾回收平台基于SSM的学生信息管理系统基于SSM的图书管理系统基于SSM的校园招聘系统

3000多套精心整理的JAVA项目源码合集，涵盖了SSM Springboot JSP、Vue框架，uniapp等。这些源码经过精心筛选和整理，质量上乘，适合各种技术水平的开发者使用和学习。含全部项目，可以自己挑选合适的 3300套JAVA毕业设计… · 2026/9/25 12:20:11

phpenv 安装和配置指南

1. 项目基础介绍和主要编程语言项目介绍phpenv 是一个用于简化管理多个 PHP 版本的开源项目。它允许开发者在同一台机器上安装和管理多个 PHP 版本，并轻松地在这些版本之间切换。phpenv 的设计初衷是为了让开发者能够更方便地测试和开发不同版本的 PHP 应用程序。主… · 2026/9/25 22:41:40

使用k8s部署wordpress的完整流程

一、部署流程：制作服务镜像1.1 准备合适的基础镜像1.2 准备代码相关文件1.3 通过dockerfile构建镜像制作kubernets 服务器，并完成调度2.1 确定服务的运行模式 ，内部还是对外提供服务2.2 确定服务所使用的控制器2.3 服务是否需要后端存储pvc2… · 2026/9/25 22:41:40

高效阅读鸿蒙版仓库：从源码拉取到跨仓解析的实践指南

简介：面向鸿蒙开发者的阅读应用鸿蒙版仓库资源，基于阅读3.0核心逻辑构建，主要提供两种API调用方式：Web方式与Content Provider方式。资源内含可按需调用的url唤起导入机制，支持通过legado://import/{path}?src{url}格… · 2026/9/25 22:41:33

ChatGPT Shortcut Firefox 扩展配置指南：固定扩展与授权运行，让提示词侧边栏在 ChatGPT、Gemini 上正常显示

AI 应用提示工程人工智能前端【免费下载链接】ChatGPT-Shortcut Stop writing prompts from scratch — a searchable prompt library for ChatGPT, Claude, Gemini and Cursor Русский 한국어 العربية हिन्दी ไทย ｜ 别再从头写提示词&… · 2026/9/25 22:41:33

Advanced Installer 22.5 实战：打造可靠的 Windows MSI 安装包

简介：Advanced Installer 22.5 打包 Windows 安装包的完整资源集，主要面向需要制作或维护安装程序的软件开发者、IT 运维与打包工程师，可帮助快速搭建专业、稳定的 Windows 安装部署方案。包内共收录 2000 个文件，压缩后大小约 22… · 2026/9/25 22:41:27

BERTopic实战：从嵌入到聚类，轻松搞定语义主题建模

简介：这套BERTopic模型教程代码包面向自然语言处理与主题建模入门者，聚焦如何用BERT文本嵌入替换传统词袋表示，再经UMAP降维、HDBSCAN聚类和类间词频逆文档频率生成主题，解决传统LDA忽略语义关联的问题，适合文本挖掘、… · 2026/9/25 22:41:01

数值优化（Numerical Optimization）学习系列-03-共轭梯度方法（Conjugate Gradient）

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/25 1:00:31

创维E900V22D刷机全攻略：S905L3SB芯片兼容性解析与救砖实战

MQTT协议原理与Broker服务器搭建实战：从Mosquitto到EMQX

设计Agent 生成代码的 Lint 规则体系，理解 Hook 机制

相关推荐

了解更多？预约专属演示