Codex 技能能跑起来之后,还有一层可选的东西:元数据。
可选,但值得配
技能目录里可以放一份 agents 目录下的配置文件。
它管三件事。界面上的展示信息,技能的调用策略,还有它依赖哪些工具。
不写也能用。写了,界面上更像一个正经模块。

界面信息写这几项
显示名,可以跟技能目录名不一样。
一句话简介,界面上悬停或者列表里会用到。
图标分小图和大图两种,一般放在 assets 目录下。
品牌色,界面元素会取这个颜色。
默认提示词,调用这个技能时会一并带上。
调用策略:那一行开关
策略里有个开关,控制隐式调用,默认开着。
意思是默认情况下,只要你的需求跟技能描述对得上,它会自动用上这个技能。
关掉会怎样。它不再根据你的提示词自动触发。但你显式点名调用,照样有效。
有些技能你不希望它自己冒出来,就把它关上。
依赖声明
依赖下面可以列工具。
要写清四样。工具类型是什么,工具叫什么名,用途说明写一句,还有传输方式和地址。传输方式常见的是流式 HTTP。
声明之后,装的人知道这个技能背后要连什么服务,不用猜。
什么时候该配
自己一个人用、只在命令行里跑,可以不配。
要给别人装,或者在桌面应用的界面上露脸,就配上。省得对方装完不知道怎么找到它。
