---

name: remember-as-rule-or-skill

description: 当用户要求「记住」某事时，根据内容类型自动添加为项目规则（.cursor/rules）或 Skill（.cursor/skills）。Use when user says 记住、记一下、以后要、保存这个规则、加到规范里、写进 skill、记录下来、按这个来.

记住 → 自动添加规则或 Skill

一、何时触发

当用户表达希望持久化当前约定/偏好时，必须走本流程，将内容写入 .cursor/rules/ 或 .cursor/skills/。

触发表述（示例）

• 记住 / 记一下 / 以后要 / 保存 / 记录下来
• 加到规范里 / 写进规则 / 写进 skill
• 按这个来 / 以后都按这个做
• 类似的自然语言表达

触发后：先判断类型（Rule vs Skill），再执行添加或更新。

---

二、Rule 还是 Skill？判断标准

类型	适合内容	存放位置	特点
Rule	简短约束、禁止项、风格约定、回复格式等「每次都要遵守」的规范	.cursor/rules/*.mdc	可 alwaysApply 或按文件 glob 生效；单条规则建议 ≤50 行
Skill	有步骤的流程、按场景触发的知识、需要 description 匹配的专项能力	.cursor/skills/<name>/SKILL.md	通过 description 在相关场景被引用；可含多节、示例

选择 Rule 的情况

• 禁止或必须做的一句话/短条款（如：禁止用 Guid、GET 用 data 传参）
• 编码/格式约定（缩进、命名、注释要求）
• 回复或交互约定（如：回复前缀「大哥」）
• 仅在某类文件生效的规范（如仅 **/*.vue）→ 用 globs，alwaysApply: false

选择 Skill 的情况

• 多步骤流程（如：接口测试流程、查库验证流程）
• 按场景触发的专项知识（如：弃用表、API 注释格式、MCP 查库）
• 需要示例、模板、清单的说明
• 内容较长或需要分节、可检索的文档

与现有内容的关系

• 若与现有 rule/skill 主题一致（如同属「接口规范」）→ 优先更新已有文件，避免碎片化
• 若是全新主题 → 新建 rule 或 skill

---

三、执行步骤

Step 1：确认要记的内容

• 从对话中提炼出用户要持久化的具体条文或流程
• 若含糊，可追问一句再落笔

Step 2：决定 Rule 还是 Skill，以及目标文件

• 按上表判断：Rule 还是 Skill
• 若为 Rule：决定是新增一个 .mdc 还是追加到现有 rule（如 project_rules.mdc 的某节）
• 若为 Skill：决定是新建 skill 目录还是更新现有 skill（如 api-xml-comments）

Step 3：写入或更新

Rule（.cursor/rules/xxx.mdc）

• 格式：YAML frontmatter + Markdown 正文
• 必填：description；若全局生效则 alwaysApply: true；若按文件则 globs: "**/*.xx"、alwaysApply: false
• 正文简洁、可执行，单条规则尽量控制在约 50 行内

---
description: 简短说明这条规则做什么
alwaysApply: true
---
# 规则标题
内容...

Skill（.cursor/skills//SKILL.md）

• 格式：YAML frontmatter（name、description）+ Markdown 正文
• description 要包含触发场景/关键词，便于 AI 在相关任务时引用
• 正文可含：何时用、步骤、示例、注意事项

---
name: skill-name
description: 做什么；在什么场景下使用（含触发词）
---
# 标题
## 何时使用
...
## 步骤/规范
...

Step 4：确认

• 写完后简短说明：写到了哪（规则还是 skill、文件名），以及以后如何生效（例如「全局规则每次都会应用」或「在提到接口测试时会用对应 skill」）

---

四、本项目约定

• 规则与 skill 的路径：项目内统一用 项目级 配置：
  • 规则：.cursor/rules/
  • Skill：.cursor/skills/
• 与「不随意生成 md」的关系：用户明确要求记住/保存规则或写进 skill 时，属于「要求生成或修改配置文档」的例外，可以且应当新增或修改 .cursor/rules/、.cursor/skills/ 下的文件。
• 风格：与现有 project_rules.mdc、orchestrator-first.mdc 以及各 skill 的写法保持一致（中文说明、清单式条款、必要时代码块示例）。

---

五、小结

用户说	你要做的
记住 / 记一下 / 以后要 / 保存规则 / 加到规范 / 写进 skill	触发本 skill
内容像「禁止/必须/约定」的短条款	写入或合并到 Rule（.mdc）
内容像「流程/步骤/场景知识」	写入或合并到 Skill（SKILL.md）
与现有某 rule/skill 同主题	优先更新该文件
写完后	说明写到了哪、以后如何生效