用途
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”,则应改为建议钩子。如果是“当我要求发布时”,则保留为技能。
注意事项
- 每个工作流优先只用一个技能——避免试图覆盖所有情况的巨型技能。
- 如果工作流演进,更新已有技能,而不是新增重复项。
限制
资料未提供该技能的收费、价格、平台支持范围或效果数据。