npm 包中的智能体技能：向智能体传递库知识

文章讨论了如何通过npm包分发Agent Skills，这是一种用于AI代理指令的开放格式。当代理遇到新的库时，探索源代码虽然有效但效率不高；作者了解要点，并可以将这些要点编码在包内skills/目录下的SKILL.md文件中。该文件包含YAML元数据和指令，并可选包含references/以提供详细信息。例如，@teqfw/db包含一个这样的技能，它告诉代理如何正确使用该包，避免使用私有API，尊重事务边界，并且在数据库重建时不做假设。将技能与npm包捆绑在一起，确保代理获得与版本匹配的指令，在安装和回滚时更新。然而，仅仅在node_modules中有技能并不能自动启用它；项目必须明确链接它，例如通过.agents/skills中的符号链接，以控制哪些依赖项能够影响代理行为。作者在TeqFW包（如@teqfw/di、cfg、cli、log、db以及@flancer32/teq-web）中实现了这一点。局限性包括可能的误解、过时的技能和上下文膨胀，因此技能应简洁，并作为代码、类型和README的补充。相关工作包括Agent Skills仓库中的RFC和skills-npm项目。作者将这种模式称为“依赖绑定的Agent Skills”。