Agent 工程实践简报 · 2026-11-14

今日概念:Dependency cooldown(依赖冷却期):新发布的包先晾几天,再允许安装

是什么:在包管理器里设一个「最短发布时间」,比如 3 天或 7 天。某个包的新版本发布不满这个时间,安装时就当它不存在,自动用更早的版本。不需要额外工具,主流包管理器都内置了这个配置,只是名字和单位各不相同:

解决什么:供应链投毒通常是这样:有人盗了某个流行包的发布权限,推一个带恶意代码的新版本。pnpm 官方博客说,这类恶意版本大多在一小时内就会被发现并下架。所以你晚几天再装,基本就躲过去了。agent 的问题在于它装依赖很勤快,经常顺手 npm install 某某@latest。Semgrep CEO Isaac Evans 上周在 Stanford CS146S 讲课时说,依赖冷却期是「最便宜、最有效的供应链防御」,并且要用确定性 hook 强制执行,而不是在说明书里叮嘱 agent。

和你已会的东西的关系:

入门原文:Dependency Cooldowns(各包管理器配置对照表,含单位和版本要求);背景读 Package Managers Need to Cool Down(Andrew Nesbitt);出处 Mihail Eric 转述 Isaac Evans 在 CS146S 的分享

上手 prompt:

目标:给这个仓库加上「依赖冷却期」(dependency cooldown),让任何人或 agent 都装不上发布不满 7 天的包版本。先出方案,等我确认再改文件。

1. 先读仓库:找出用了哪些包管理器(看 lockfile、package.json 的 packageManager 字段、pyproject.toml、CI 配置等),并确认每个包管理器在本地和 CI 里的实际版本(跑 --version,CI 里看 setup 步骤)。列出证据:文件路径和命令输出。
2. 对每个包管理器,按 https://cooldowns.dev/ 查对应的配置键、单位和最低版本,写出要改的配置。必须换算对单位(npm 按天、pnpm 按分钟、Bun 按秒、Yarn 和 uv 写时长字符串)。如果当前版本低于最低支持版本,明确告诉我:配置会被静默忽略,并给出升级方案或一个在版本过低时让安装失败的检查。
3. 列出需要豁免的包(例如本组织自己发布的内部包),只豁免确实归我们所有的 scope,说明理由。不确定的标成「待我确认」。
4. 验证:配置写好后,找一个发布不到 7 天的真实包版本(用 npm view <pkg> time 或对应命令查发布时间)尝试安装,贴出被拒绝或被降级的输出;再跑一次正常安装,证明现有 lockfile 不受影响。不要提交任何改动。
5. 最后给我一张表:包管理器 / 版本 / 配置文件 / 配置值 / 验证结果,并贴出 git diff。

参考:cooldowns.dev https://cooldowns.dev/ ;Isaac Evans(Semgrep)在 Stanford CS146S 的分享,Mihail Eric 转述 https://x.com/mihail_eric/status/2121314052320444471

本期条目

1. 说明书里的规则,agent 要么每次都听,要么一次都不听:2,053 条真实规则里,54% 每次遵守,37% 从没遵守过

目标:测出这个仓库的 agent 说明书(AGENTS.md、CLAUDE.md、.github/copilot-instructions.md 等,以仓库里实际存在的为准)中,哪些规则 agent 真的在遵守,哪些从没被遵守。只读分析,不改任何文件。

1. 找出仓库里所有 agent 说明书文件,逐条抽取「明确、可执行、能在 commit 里看出来」的规则(例如「测试文件放在 X 目录」「不许用 Y 库」「commit message 用 Z 格式」)。只能靠人判断、在代码里留不下痕迹的规则(如「先想清楚再写」)单独列出,标成「不可检查」。
2. 用 git log 找出最近由 agent 写的 commit(看 Co-authored-by、提交者名字、commit message 里的工具标记等;判断依据要贴出来)。如果分辨不出哪些是 agent 写的,就用最近 50 个 commit,并在报告里说明这个限制。
3. 对每条可检查规则写一个小检查脚本:输入一个 commit,输出「遵守 / 违反 / 不适用」(commit 没碰到这条规则管的文件就算不适用)。先用一个明显遵守和一个明显违反的例子验证脚本本身是对的,再拿去跑真实 commit。
4. 输出一张表:规则原文 / 所在文件和行号 / 适用的 commit 数 / 遵守率 / 一个违反的 commit 哈希作证据。适用 commit 少于 3 个的,标成「样本太少」。
5. 对遵守率为 0 或很低的规则,给出处理建议:改写措辞、删掉,还是改成 hook / lint / CI 检查(写出具体检查长什么样)。等我确认再动手。

参考:Voria、Kashiwa、Catolino、Palomba,《Do They Do as They Are Told? Investigating Coding Agents' Adherence to Explicit Instructions in Context Files》https://arxiv.org/abs/2611.13709

2. Claude Code 的 advisor:日常用便宜模型干活,只在关键节点请更强的模型「看一眼」

目标:在这个仓库里对比两种 Claude Code 配置,看 advisor tool 值不值得开:A = 只用当前主模型;B = 当前主模型 + /advisor 设为更强一档的模型。只测试,不合并任何改动。

1. 先读 https://code.claude.com/docs/en/advisor ,确认我当前的 Claude Code 版本、主模型和账号类型支持 advisor(跑 claude --version,并说明依据)。不支持就停下来,告诉我原因。
2. 从仓库的 git 历史里挑 3 个过去真实发生过、已经修好的问题(最好是一个多文件重构、一个反复出错才修好的 bug、一个小改动),把代码切回修复前的 commit,在独立的 git worktree 里分别用 A 和 B 各跑一次。验收标准用当初修复时加的测试,或者仓库现有的测试命令(先读仓库确认实际命令)。
3. 每次运行记录:是否通过验收、用了多少轮、token 或费用(用 /cost 或会话结束时的统计)、advisor 被调用了几次、在什么时刻被调用。
4. 输出对比表,并给结论:在哪类任务上 B 更值,在哪类任务上没区别。样本只有 3 个,结论要注明「仅供参考」,不要夸大。
5. 跑完删除临时 worktree,贴出 git worktree list 和 git status,证明主工作区没被改动。

参考:Anthropic,Claude Code 文档「Escalate hard decisions with the advisor tool」https://code.claude.com/docs/en/advisor

3. 让 agent 去「交付安全功能」,而不是只去找 bug:从 CI 里每个 GitHub Action 锁死到具体版本开始

目标:把这个仓库 CI 里引用的所有第三方 GitHub Action 锁定到完整的 commit SHA,防止上游打 tag 后被篡改导致供应链攻击。先出方案,等我确认再改文件。

1. 找出 .github/workflows/ 和 .github/actions/ 下所有 uses: 引用(包括可复用 workflow 和组合 action 里的)。列成表:文件 / 行号 / 当前引用(如 actions/checkout@v4)/ 是否已是 40 位 SHA。仓库没有 GitHub Actions 的话就停下来告诉我。
2. 对每个还没锁定的引用,用只读方式查出当前 tag 实际指向的 commit SHA(例如 git ls-remote https://github.com/<owner>/<repo> refs/tags/<tag>,注意 annotated tag 要取解引用后的 ^{} 那一行)。贴出每条命令的输出作为证据,查不到的不要猜,标成「未解析」。
3. 改写为 uses: owner/repo@<完整SHA> # <原tag>,保留注释方便以后升级。本地 action(uses: ./...)和同组织内的 action 单独列出,问我要不要一起锁。
4. 检查仓库是否已有 Dependabot 或 Renovate 配置;如果没有,给出一个让它自动更新 SHA 锁定版本的最小配置草稿,但不要提交。
5. 验证:如果仓库能用 actionlint 或类似工具,就跑一次并贴出结果;最后贴出 git diff,不要 push、不要开 PR。

参考:Isaac Evans(Semgrep)在 Stanford CS146S 的分享,Mihail Eric 转述 https://x.com/mihail_eric/status/2121314052320444471

本期去重用源链接(机器可读)