当同一多步工作流在 Cursor 中反复出现时…

在 Cursor 里发现用户反复要求同一套步骤、或 agent 每次都在重新推导相同流程时，将其提炼成 .cursor/skills/ 下的 SKILL.md 以便后续自动加载。

适用场景

解决思路

1. 识别触发信号：用户已三次以上要求同一序列（例如“提交前总是先跑 lint、再 tsc、再 test”）；或 agent 注意到自己在每个任务里都在重新推导相同步骤（例如“如何部署预览分支”）；或某条纠正听起来像策略（例如“这里绝不用裸 SQL——始终走 repository 层”）。
2. 区分机制：如果该模式是带步骤的流程，用 skill；如果是始终生效的约定，配合 suggesting-cursor-rules 做成 rule；如果是“每次保存后自动执行 X”，则建议做成 hook。
3. 为模式命名：选一个简短的 slug（小写、连字符），例如 verifying-api-before-merge、releasing-mobile-build。
4. 创建文件：在 .cursor/skills/<slug>/SKILL.md 新建（若向上游贡献，则按本仓库模式从 resources/<slug>/SKILL.md 复制）。
5. 编写 frontmatter：name 填 slug；description 用一行说明它做什么、何时使用，并以明确的触发条件结尾；可选加 user-invocable: true 让用户能按名称调用。
6. 编写正文，保持精简：1) Title 人类可读标题；2) When to use 用要点列出；3) Steps 用编号、祈使句，必要时写出工具名（npm、gh、MCP 工具）；4) Notes 写边界情况、安全事项、何时不要用。
7. 语气与仓库中其他 skill 保持一致：具体命令、不要废话。
8. 校验 description 是否足够具体，能让 Cursor 在用户描述任务时匹配到该 skill。
9. 校验步骤是否可被 agent 直接执行而无需猜测仓库结构（否则写明“从 lockfile 检测包管理器”）。
10. 校验不包含任何密钥或机器特定路径。
11. 告知用户文件所在位置，并说明 agent 会在该工作区的下一次对话中自动加载它。
12. 遵循一条工作流一个 skill 的原则，避免试图覆盖所有情况的巨型 skill。
13. 若工作流演进，更新已有 skill，而不是新增重复的 skill。

适用边界 · 注意事项

• 该模式是“每次保存后自动执行 X”这类事件驱动场景——应改用 hook。
• 该模式是始终生效的约定、风格或文件匹配规则——应改用 rule。
• 尚未重复出现（少于三次）或只是临时性步骤——不值得固化为 skill。