SuperAPI AI 工具集

building-skills-from-patterns

智能体与模型

查看项目

更新于 10-16 02:41

技能介绍

用途

Building Skills From Patterns 是一个元技能(meta-skill),用于把重复出现的“肌肉记忆”提升为具名技能:研究一次、把工作流编码下来、之后永久复用。技能本身是可复用的 SKILL.md 文件。

何时触发

  • 用户已经三次或更多次要求同一套操作序列(例如“提交前总是先跑 lint,再跑 tsc,再跑测试”)。
  • 智能体注意到自己在仓库中的每个任务上都在重新推导相同的步骤(例如“我们如何部署预览分支”)。
  • 某条纠正听起来像一条策略(例如“这里绝不要用裸 SQL——始终走 repository 层”)。如果它应当是始终生效的,则配合 suggesting-cursor-rules 使用;如果它是一套带步骤的流程,则使用技能。

工作流

1. 命名模式

选择一个简短的 slug(小写、连字符),例如 verifying-api-before-merge、releasing-mobile-build 等。

2. 起草 SKILL.md

创建 .cursor/skills/<slug>/SKILL.md(或按本仓库的模式,在向上游贡献时从 resources/<slug>/SKILL.md 复制)。

Frontmatter:


name: <slug> description: One line: what it does and when to use it. Ends with a clear trigger. user-invocable: true # optional, if the user should be able to invoke by name

正文分节(保持精简):

  • Title —— 人类可读的标题。
  • When to use —— 要点列表。
  • Steps —— 编号、祈使句,在有用处写出工具名(npm、gh、MCP 工具)。
  • Notes —— 边界情况、安全性、何时不要使用。

与仓库中其他技能的语气保持一致:具体命令,不要填充内容。

3. 校验

  • 描述要足够具体,使 Cursor 在用户描述任务时能匹配到该技能。
  • 步骤要能被智能体执行而无需猜测仓库布局(或写明“从 lockfile 检测包管理器”)。
  • 不含密钥或机器特定路径。

4. 向用户指出它

告诉用户文件所在位置,以及智能体将在该工作区的下一次对话中自动采用它。

与规则和钩子的关系

机制 用于
Skill 按需执行的流程、带分支的步骤、工具使用。
Rule(.cursor/rules/) 始终生效的约定、风格、文件模式。
Hook(.cursor/hooks.json) 在文件保存 / 停止事件后自动执行。

如果模式是“每次我保存时,运行 X”,则应改为建议钩子。如果是“当我要求发布时”,则保留为技能。

注意事项

  • 每个工作流优先只用一个技能——避免试图覆盖所有情况的巨型技能。
  • 如果工作流演进,更新已有技能,而不是新增重复项。

限制

资料未提供该技能的收费、价格、平台支持范围或效果数据。