SuperAPI AI 工具集

building-skills-from-patterns

智能体与模型

查看项目

更新于 10-15 21:04

技能介绍

用途:当同一多步骤工作流在 Cursor 中反复出现(用户多次要求相同顺序,或智能体每次任务都重新推导相同步骤),该元技能会把它固化为一个具名技能,实现“研究一次、编码流程、永久复用”。

触发时机:用户三次以上要求同一序列(如提交前总是先 lint、再 tsc、再 test);智能体发现自己在同一仓库反复推导相同步骤;某条纠正听起来像策略(如“这里绝不用裸 SQL,始终走 repository 层”)。若属于始终生效的约定,应配合 suggesting-cursor-rules;若是有步骤的流程,则用技能。

工作流:1)命名模式,选小写连字符短 slug,如 verifying-api-before-merge。2)起草 SKILL.md,创建 .cursor/skills/<slug>/SKILL.md(向上游贡献时按仓库模式从 resources/<slug>/SKILL.md 复制)。frontmatter 含 name、description(一行说明做什么、何时用,以明确触发条件结尾)、可选 user-invocable。正文保持精简:标题、何时使用(要点)、步骤(编号、祈使句、必要时写工具名如 npm、gh、MCP 工具)、注意事项(边界情况、安全、何时不用)。3)校验:描述要具体到 Cursor 能匹配;步骤可被智能体执行而无需猜测仓库结构(或写明“从 lockfile 检测包管理器”);不含密钥或机器特定路径。4)告知用户文件位置,并说明下次在该工作区聊天时智能体会自动采用。

与规则、钩子的关系:技能用于按需流程、分支步骤、工具使用;规则(.cursor/rules/)用于始终生效的约定、风格、文件模式;钩子(.cursor/hooks.json)用于文件保存或停止事件后的自动化。若是“每次保存都运行 X”,应建议钩子;若是“当我要求发布时”,保留为技能。

限制与注意:每个工作流尽量只用一个技能,避免覆盖所有情况的巨型技能;流程演进时更新已有技能而非新增重复项。