#claude-code
23 篇文章Claude Code 的 prompt-audit：先删掉过期指令，再让 agent 写代码
部署已经迁移，agent 却还在照旧文档跑命令？用 Claude Code 的指令审计找出失效路径、冲突规则和旧流程，再用真实构建验证修改。
别把纠错都塞进 AGENTS.md：给 agent 记忆做一条晋升流水线
把临时发现、重复纠错和硬性约束分开管理，避免项目指令逐渐膨胀，最后谁也不遵守。
权限拒绝以后，别让 agent 原地重试：用 PermissionDenied 给出可执行改道
自动模式拒绝工具调用时，最浪费时间的不是那次拒绝，而是 agent 带着同一条命令反复撞墙。把拒绝原因变成受约束的改道提示，再决定哪些场景允许重试。
别让并行 agent 各自绿灯：用 PostToolBatch 收口集成验收
一次并行调用五件事，单点都成功但合起来不成立。Claude Code 在整批工具调用结算后留了 PostToolBatch 触发点，用它做批后集成检查，再用 Stop 把没验证的改动拦回去。
退出码 2 才是门：hook 阻断信号的按事件契约
exit 1 表示失败是 Unix 常识，放进 hook 里却等于把门开着。把拦截信号按事件对齐，再用一台本地自检台证明它真的拦得住。
钩子装上了不等于生效：把 PreToolUse 收窄并审计
拦截型 hook 的价值取决于它有没有真的触发。用 if 条件收窄触发面，用信任规则和调试日志证明它确实在跑。
把编排写进脚本：动态工作流一次跑上百个子代理，先管住三件事
子代理派到几十个就乱了。Claude Code 的动态工作流把计划和分支写进脚本，代价是并发、恢复和成本都得你自己管。这里是我跑大规模扇出前会先看的几条硬边界。
让子代理带着技能上岗：拆开计划、实现和验收的上下文
别给所有子代理塞同一套长提示。用预加载 Skill 定义角色，用文件契约交接，把计划、实现和验收拆成可复查的流水线。
无人值守的 agent，先钉死隔离边界和出网白名单
让 coding agent 少问甚至不问的前提不是提示词，而是隔离边界和出网白名单。用官方 dev container 参考配置搭一套默认拒绝出网的容器：非 root 用户、ipset 白名单、托管设置禁掉 bypass，再逐条排查会悄悄吃掉隔离的四个配置。
让 coding agent 自己暴露错误：用 Hook 做最短反馈回路
把格式化、定向测试和失败摘要挂到 agent 的工具调用之后，让错误在下一步决策前出现，而不是堆到提交前。
省 token 不等于省钱：给 agent 成本做一次 cache 感知核算
压掉 38% 工具输出 token，账单反而涨 6.8%。把成本拆成输入、缓存写、缓存读、输出四格，再加上空闲驱逐这条暗线，才能看清 coding agent 的钱花在哪。
别靠祈祷触发：给 agent Skill 写一套路由回归测试
Skill 的 description 实际上是 agent 的路由规则。把真实任务写成应触发与不应触发的测试集，再记录误触发和漏触发，才能让 Skill 库越长越可靠。
把子代理路由写成生产规则
description 是派单系统的路由表，工具列表是能力边界，per-agent hook 是审计员。四件事都固化下来，委托才从模型的即兴发挥变成可审查的常量。
给 agent 的 diff 设预算：把验收变成自动闸门
agent 一小时能产出人类一天都审不完的 diff。与其事后在巨型 PR 里找问题，不如把变更大小、测试和破坏性改动写进验收清单，再用 hook 在它声称完成的那一刻强制检查。
给并行 agent 一人一个 worktree：让子代理真的敢同时改代码
子代理并行时最怕互相踩 diff：两个 agent 同时改同一个工作目录，后写的一方静默覆盖先写的一方。用 isolation: worktree 让每个写代码的子代理落在独立 git worktree 里，并行才真正成立。
别让子代理替你拍板：给 Agent Team 建立证据交接协议
把子代理输出从一段“看起来合理”的总结，改造成主代理能复查、能执行、能拒绝的证据包。
别把流程塞进 AGENTS.md：用 Skills 给 coding agent 做可复用工序
把稳定约束留在 AGENTS.md，把按需展开的复杂流程封装为 Skills，再以只读子代理隔离噪声，给 coding agent 一套能长期维护的操作系统。
Hook 不止能挡：把 agent 变成可编程流水线
PreToolUse 拦截只是 hook 的入门用法。上下文注入、环境同步、通知、后台测试、审计日志，同一套事件总线把 coding agent 变成确定性的自动化流水线，而且 Claude Code、VS Code、Copilot 共用同一份 JSON 配置。
把 agent 指令拆成目录规则：减少上下文冲突的实战
把全局原则、目录约束和任务卡分层放置，让 coding agent 在正确的文件范围内拿到正确的规则，减少冲突和无效上下文。
给编码 agent 一份真正的项目说明书：把 AGENTS.md 写到能用
AGENTS.md 每次会话都会进上下文，是性价比最高的 agent 提效文件。命令先行、短而具体、边界明确、按目录嵌套，四条规则让规则真正被遵守。
把并行 agent 收进一个可合并的交付面：子代理边界实战
并行不是多开几个 agent。给每个子代理缩小任务、工具和写入面，再让主代理做唯一集成者，才能避免互相覆盖。
Hook 即闸门：把 agent 行为焊死在流程里
CLAUDE.md 是建议，hook 是规定。从 stdin JSON 协议、退出码语义到 prompt/agent 型 hook，把编码 agent 的每个动作变成可拦截、可验证、可审计的确定性流程。
给 agent 一个可验证的终点：/goal 完成条件实战
把完成条件写成可验证的句子，agent 自己循环到满足为止。终点、证据、边界、上限，缺一个就烧 token。