P305 · Skill 编写

实时查询可执行的环境事实

Environment as instruction source of truth

对便宜且可直接检查的环境信息,避免维护容易过期的文字副本。

编辑审核

以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。

使用场景

项目check脚本已从旧命令换到新命令,但多份Agent文档复制旧字符串。能便宜读取的环境事实应从当前配置获得,文档保留找不到的原因与约定。

具体做法

确定事实权威,如实际安装边界package.json、锁文件与CI入口。给文档精确指针和需读取字段,保留为什么需要集成夹具、权限和特殊环境等隐含理由。执行前先读取可信配置;–help本身会执行程序,未知工具先核可信来源。昂贵查询可缓存但记录时间/负责人/失效,冲突先查权威。

反例

把脚本复制到三份规则,改一份忘两份;为查命令直接运行未知下载程序help。

改进写法

指向当前项目package.json的check字段及CI契约,另说明集成夹具覆盖哪个跨模块失败。核实际配置后运行授权检查,不维护多份字符串;若查询昂贵需缓存,标来源、时间和刷新条件。

为什么这样改

复制是缓存,容易随环境漂移。便宜查权威减少同步负担,文档集中不可直接查出的理由,也提高维护价值。

如何验证

教学脚本改名后只需权威配置变更,Agent通过指针发现新命令。文档保留夹具原因但无旧命令副本。核脚本存在、可信与适用,而不是标题叫check就认为可执行。

适用边界

配置也可能错误,权威不证明安全或成功,须实际检查。网络/外部查询成本高时缓存合理;生成文档可以同步,但需验证。当前未执行冻结技能的命令。

原文与版本

如何收录这些方法