Skip to main content

技能目录

技能是方法层:一份告诉专家”这类活该怎么干”的文档,通常还附带可执行脚本与模板。工具决定专家能做什么,技能决定它做得好不好 这一页穷举平台内置技能,并说明技能的三路归属。

三路归属(这是最关键的一件事)

一次对话可用的技能是三个来源的并集,互不覆盖:
同名不冲突:builtin/docxuser/docxexpert/docx 可以同时存在。专家在 skill discover 里看到的是限定名,激活时必须写全,否则裸名在多路同名时会拒绝解析而不是猜。
写入入口按归属严格分离: 自由聊天、IM 渠道等没有专家上下文的对话里调 skill_install 会被拒绝,并引导你去界面装到全局库。这是刻意的——没有归属对象的技能不知道该存到哪个专家名下。 内置技能永远不入库。改它们意味着改镜像并发版。

技能怎么被用起来

1

discover

专家调 skill(action="discover") 拿到清单,只看到名称 + 描述,不加载正文
2

activate

判断相关后调 skill(action="activate", name="builtin/pptx") 才把完整正文读进上下文。
3

execute

需要脚本或模板时调 skill(action="execute", resource_type="script", resource_name="...")。脚本黑盒执行,只回 stdout/stderr,源码不进上下文。
这个两段式(先看目录再读正文)是必须的:下表里 builtin/pptx 34,079 字符、builtin/kami 31,269 字符,全量注入会直接吃掉大半个上下文窗口。

内置技能全表

按插件分组。字符数是技能文档正文长度,用来判断激活它的上下文代价。

文档处理

pptxkami 是全站最长的两篇,因为它们承载完整的产线规范(模板、脚本调用、导出锁)。

可视化(22 篇)

profy-visualize 的 manifest 里只声明了 8 篇,但目录里有 22 篇。差额不是错误:声明的那 8 篇随插件激活直接注入清单,其余 14 篇按需通过 discover 发现后 activate。这是防止插件一开就往上下文里塞 22 篇目录。

游戏开发(10 篇)

视频与创意

桌面与专业软件桥接

三个软件桥接技能都很短(1,284–2,015 字符),因为它们只写工作流纪律,具体操作依赖 MCP 工具——而那部分当前未接线,详见各插件单页的已知缺陷。

录制回放(9 篇,扁平文件)

profy-record-and-replay 的技能以扁平 .md 存放而非目录结构: app-* 系列是逐应用的操作谱——同一个”点播放”在不同 App 里的可访问性树结构不同,必须逐个记。

平台机制类

builtin/evolutionbuiltin/distill 只在对应的内部模式下可见,普通对话看不到。

技能怎么写

一篇技能是一个目录,至少含 SKILL.md
SKILL.md 的 frontmatter:
description 决定这篇技能会不会被想起来。专家在 discover 时只看到它,正文再好、描述含糊就永远不会被激活。写法上要写「什么时候用」而不是「这是什么」。对照本页表格里的描述:builtin/xlsx 写的是「任何以表格为主要输入或输出的任务」——这是触发条件;不是「Excel 处理能力」——那是自我介绍。

上下文成本

技能正文在 activate 时全量进上下文。参考量级: 这也是自进化context_footprint 单列一个评分维度、且由代码而非模型自评的原因:写得越长越详细,模型自评往往越高分,但真实代价是每次调用都要付的上下文。

相关页面

技能系统

技能的概念与使用

工具全表

skillskill_manage 的完整签名

插件全表

技能随哪个插件提供

自进化

技能怎么自动变好
核对日期 2026-08-11。来源:services/agent-runtime/src/plugins/builtin/*/skills/(47 个目录式技能 + 7 个扁平 SKILL.md + 9 个 record-and-replay 扁平文件)。字符数为文档实测长度。