一句话定义
把技能分享给别人用之前,要把使用前提、依赖的专属资源、以及可能涉及的安全和隐私风险都交代清楚,而不是假设别人的环境和自己一样。
机制 / 原理
技能作者往往是在自己特定的环境里把技能调试到位的,环境里可能悄悄依赖了只有自己有的东西——比如某个内部数据库的表结构、某个只装在自己电脑上的工具、或者默认了某种只有本团队才有的数据格式。如果不把这些隐性依赖显式列出来,别人拿到技能会在看似能跑但结果不对这种最难排查的状态里卡住。同时因为技能可能会读取或生成敏感数据,分享前也要想清楚谁能看到这些数据、会不会被记录或外传。
经典实验 / 例子
一个人做了一个把自然语言问题转成SQL查询的技能,自己用得很顺手,是因为他机器上默认连着公司的生产数据库、而且技能里假设的表名和字段名就是他们组的命名习惯。分享给另一个部门前,需要说明清楚:这个技能假设了怎样的数据库结构、需要哪些权限才能连接、生成的SQL在执行前建议先人工过一遍避免误删数据,而不是让对方直接连自己的生产库运行。
生活中的例子
有点像把自己家的备用钥匙借给朋友帮忙浇花,得提前说清楚哪把钥匙开哪道门、警报器怎么解除、哪个抽屉里有重要文件不要碰,而不是扔给一串钥匙就让对方自己摸索。
常见误区
最容易忽略的是这在我这里明明好用的思维定式,作者对自己环境里的默认设置习以为常,意识不到那些设置对别人来说其实是隐藏的前提条件,结果别人用起来处处踩坑却找不到原因。