docs(agents): clarify offline index contract exemption scope

静态索引合同免排队仅限直接扫描文件的只读脚本；node --test 形式的合同测试与 pnpm test/typecheck/build、mvn 仍必须经 local-check.ps1。
2026-10-20 13:41:28 +08:00
parent 6b55816c12
commit e96d256b29
1 changed files with 1 additions and 0 deletions
@@ -27,6 +27,7 @@
 - 每个任务先完成必要的定向检查；批次收尾再统一执行应用要求的全量门禁，不因排队取消必要验证。复用结果前核对命令、目录、相关源码/依赖/配置均相同；验证期间相关输入变化则作废重跑。入口仅保存最近一次执行摘要，不自动计算代码快照、不自动跳过测试，也不保证先来先执行。
 - 本机 `owner.json`、`last-result.json` 仅保存检查名称、目录、工具、PID、时间和退出码，不保存命令参数、凭据或测试输出；名称不得包含秘密。摘要不是业务/部署事实来源。无需凭据，不访问网络、数据库或部署环境；被包装命令原有的网络/写入能力及授权要求不变。
 - 只读检索和互不冲突的编辑可并行；开发服务按应用复用已有实例，不纳入短任务队列，也不通过本入口启动常驻服务。已有运行任务由所属对话收尾；本入口不自动终止它们。
+- 免排队范围仅限离线只读的静态合同：`baiyue-firstleg/scripts/agents-index-contract.ps1`、`scripts/mapper-scan-contract.mjs` 等直接扫描文件的 PowerShell/MJS 脚本；`node --test` 形式的合同测试文件仍属测试。任何 `pnpm test`、`pnpm typecheck`、`pnpm build`、`node --test` 和 `mvn` 命令必须经 `local-check.ps1`，不得以“离线合同”为由绕过。

 ## 当前开发阶段