给 Codex 技能配图标和调用策略:agents 目录里那份可选文件

Codex 技能能跑起来之后,还有一层可选的东西:元数据。

可选,但值得配

技能目录里可以放一份 agents 目录下的配置文件。

它管三件事。界面上的展示信息,技能的调用策略,还有它依赖哪些工具。

不写也能用。写了,界面上更像一个正经模块。

技能元数据配置示意插画

界面信息写这几项

显示名,可以跟技能目录名不一样。

一句话简介,界面上悬停或者列表里会用到。

图标分小图和大图两种,一般放在 assets 目录下。

品牌色,界面元素会取这个颜色。

默认提示词,调用这个技能时会一并带上。

调用策略:那一行开关

策略里有个开关,控制隐式调用,默认开着。

意思是默认情况下,只要你的需求跟技能描述对得上,它会自动用上这个技能。

关掉会怎样。它不再根据你的提示词自动触发。但你显式点名调用,照样有效。

有些技能你不希望它自己冒出来,就把它关上。

依赖声明

依赖下面可以列工具。

要写清四样。工具类型是什么,工具叫什么名,用途说明写一句,还有传输方式和地址。传输方式常见的是流式 HTTP。

声明之后,装的人知道这个技能背后要连什么服务,不用猜。

什么时候该配

自己一个人用、只在命令行里跑,可以不配。

要给别人装,或者在桌面应用的界面上露脸,就配上。省得对方装完不知道怎么找到它。