building-skills-from-patterns

根据模式构建技能

技能是可重复使用的 SKILL.md 文件。这项元技能会指示 Agent 将重复形成的惯例整理成一个命名技能：研究一次，编写工作流，永久复用。

触发时机

• 用户三次或更多次要求执行相同的步骤序列（例如：“提交前总是先运行 lint、再运行 tsc，然后运行 test”）。
• Agent 发现自己在这个仓库的每项任务中都在重复推导相同的步骤（例如：“如何部署预览分支”）。
• 用户的纠正听起来像一项策略（“这里绝不要使用原始 SQL——始终使用仓库层”）——如果它应该始终生效，请搭配 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
---

正文部分（保持精简）：

1. 标题 — 易于理解。
2. 使用时机 — 项目符号列表。
3. 步骤 — 编号列出，使用祈使句，必要时注明工具名称（npm、gh、MCP 工具）。
4. 备注 — 边缘情况、安全事项以及不应使用的情况。

遵循仓库中其他技能的语气：使用具体命令，不说废话。

3. 验证

• 描述足够具体，能够让 Cursor 在用户描述任务时匹配该技能。
• Agent 无需猜测仓库布局即可执行这些步骤（或者注明“根据锁文件检测包管理器”）。
• 不包含密钥或特定机器的路径。

4. 告知用户

告诉用户文件的位置，以及 Agent 会在该工作区的下一次对话中读取该文件。

与规则和钩子的关系

机制	用途
技能	按需执行的流程、分支步骤、工具使用。
规则（.cursor/rules/）	始终生效的约定、风格、文件模式。
钩子（.cursor/hooks.json）	在文件保存／停止事件后自动执行。

如果模式是“每次我保存时，都运行 X”，建议使用钩子。如果模式是“当我要求发布时”，则将其保留为技能。

备注

• 尽量做到每个工作流对应一个技能——避免试图涵盖所有情况的巨型技能。
• 如果工作流发生变化，请更新现有技能，而不是添加重复技能。