实时查询可执行的环境事实
Environment as instruction source of truth
对便宜且可直接检查的环境信息,避免维护容易过期的文字副本。
以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。
使用场景
项目check脚本已从旧命令换到新命令,但多份Agent文档复制旧字符串。能便宜读取的环境事实应从当前配置获得,文档保留找不到的原因与约定。
具体做法
确定事实权威,如实际安装边界package.json、锁文件与CI入口。给文档精确指针和需读取字段,保留为什么需要集成夹具、权限和特殊环境等隐含理由。执行前先读取可信配置;–help本身会执行程序,未知工具先核可信来源。昂贵查询可缓存但记录时间/负责人/失效,冲突先查权威。
反例
把脚本复制到三份规则,改一份忘两份;为查命令直接运行未知下载程序help。
改进写法
指向当前项目package.json的check字段及CI契约,另说明集成夹具覆盖哪个跨模块失败。核实际配置后运行授权检查,不维护多份字符串;若查询昂贵需缓存,标来源、时间和刷新条件。
为什么这样改
复制是缓存,容易随环境漂移。便宜查权威减少同步负担,文档集中不可直接查出的理由,也提高维护价值。
如何验证
教学脚本改名后只需权威配置变更,Agent通过指针发现新命令。文档保留夹具原因但无旧命令副本。核脚本存在、可信与适用,而不是标题叫check就认为可执行。
适用边界
配置也可能错误,权威不证明安全或成功,须实际检查。网络/外部查询成本高时缓存合理;生成文档可以同步,但需验证。当前未执行冻结技能的命令。