工程(提交点文档域增量化批·pre-commit 触发粒度): run_all_gates.sh 增量档——--staged <清单文件> 仅配 --docs,触发矩阵唯一落点(任一 .md→06/06b/07/08/08d 先按清单内 .md 扫描·待办清单/roadmap/reports→08c 全量·systems/tests-README/reports→08e 全量·10 恒跑),快路径红必全量复跑定谳(清单面外红不入判定面,与 CI 全量严格对齐),未触发闸记 SKIP 入 not_run;user 目录隔离收窄至代码域(文档域不启引擎省 0.8 秒);pre-commit 钩子收暂存清单(quotepath 关闭保中文名,NUL 转行落临时文件)传 --staged,清单建不起回落全量档;不带 --staged=现行全量档 CI 零影响;窄测三态过(纯代码全 SKIP 6.2s/登记面 08c 触发+面外红定谳注记 7.9s/设计文档快路径 7.3s),Windows 瓶颈=python 进程启动,实际省 1-3 秒;横幅钩子与 config 注册不入 git(.zcode gitignored)随盘生效

tools/hooks/pre-commit

@@ -12,7 +12,15 @@ REPO="$(git rev-parse --show-toplevel)"
 [ -f "$(git rev-parse --git-dir)/MERGE_HEAD" ] && exit 0
 
 RC=0
-bash "$REPO/tools/run_all_gates.sh" --docs || RC=$?
+# 收暂存清单（增量档输入）：quotepath 关闭保中文名原样，NUL 转行落临时文件传闸机
+_LIST="$(mktemp "${TMPDIR:-/tmp}/gates-staged.XXXXXX")" || _LIST=""
+if [ -n "$_LIST" ]; then
+	git -C "$REPO" -c core.quotepath=false diff --cached --name-only -z | tr '\0' '\n' >"$_LIST"
+	bash "$REPO/tools/run_all_gates.sh" --docs --staged "$_LIST" || RC=$?
+	rm -f "$_LIST"
+else
+	bash "$REPO/tools/run_all_gates.sh" --docs || RC=$?
+fi
 if [ "$RC" -eq 0 ]; then
 	exit 0
 elif [ "$RC" -eq 1 ]; then