返回资料库

RESOURCE / CODE

文档滞后闸：给编码代理装的 hook

改了代码没更文档就拦住提交与推送，并告诉代理该往哪个文档写。带 44 条自检用例（含对抗性用例与显式标注的已知边界），一条命令验证它是真的在工作还是装了等于没装。

版本: 1.1.0
更新于: 2026-08-11
许可: CC BY 4.0

下载

2026-08-11

放进仓库 scripts/、按自己已有的文档规则改两个正则、按 README 里的 Claude Code 或 Codex adapter 接线，然后跑 --self-test 并在宿主里验一遍。含一段可直接交给 AI 代理自行安装的提示词。

下载 MJS 22.6 KB · SHARED 下载 MD 17.7 KB · ZH

文件校验

下载后可用 SHA-256 核对文件是否完整，校验值对应当前版本的不可变文件。

doc-freshness-hook-v1.1.0.mjs: 074e80363b2f22a2f58d19d5c0e44690c18caa2db511e01ce6365d58afafe480
doc-freshness-hook-v1.1.0-zh.md: 6839e52694103316d551a3cb9d4c15bf978adf0507d91e419b918a04e5ae80c3

来源与许可

本站原创并在自有仓库中实际运行的 Claude Code hook，不含任何第三方代码或受限资料。

本资源按 CC BY 4.0 发布；复用时请保留适当署名并注明修改。

版本记录

v1.1.0 2026-08-11
对齐 2026-08-11 的官方行为并修掉三处可复现旁路：接上 Claude Code 原生 if 预过滤与 ${CLAUDE_PROJECT_DIR} exec form；Stop 改用 hookSpecificOutput.additionalContext 并用 stop_hook_active 防重复；删掉 --amend 与 git push --tags 的整体豁免；逃生开关收紧到本次调用自己的环境变量前缀。新增可安装的 Codex adapter 与信任模型说明，自检从 21 条扩到 44 条（含对抗性用例与显式标注的已知边界）。Codex 未实测。
v1.0.0 2026-08-10
首个公开版本：提交闸、推送闸、停点提醒三种模式，命令位置匹配避免误报，-z 处理非 ASCII 路径，异常一律放行，附 21 条自检用例与给 AI 代理的安装提示词。