Knowledge

Knowledge note

把 Agent Skill 当成可发布的软件包

Skill 不只是 SKILL.md,还需要触发描述、资源边界、安全审计、版本和发布后的检索验证。

--阅读0点赞
查看公开来源

一个 Skill 在本机能运行,不代表它适合公开发布。压缩包里可能混入凭据、缓存、样例输出,也可能因为描述过于宽泛而在错误的任务中被触发。

发布前的四层检查

结构

确认 SKILL.md frontmatter、目录名、资源链接和 UI metadata 一致。删除模板残留与无用资源。

权限与秘密

审计 scripts、环境变量读取、网络访问和文件范围。对 ZIP 做最终内容清单,而不是只看工作目录。

可发现性

名称要说明能力,description 要同时包含“做什么”和“什么时候触发”。展示文案可以更短,但不能替代触发描述。

可追溯发布

版本、Git commit、Release asset 和平台条目应该能相互对应。上架后再次搜索关键词,确认真实展示结果与预期一致。