个人知识库

IDE Rules

7分钟阅读

IDE Rules

AI IDE 中的规则资产：一份（组）Markdown 规范，在执行任务前注入模型上下文，约束「何时调用工具、如何改状态、写代码遵循什么」，把点动指令升级为自动闭环。

简介

IDE Rules（各产品名称不一：Trae Rules、Cursor Rules、以及生态中的 AGENTS.md 规范文件 / CLAUDE.md 项目指令）本质是写给模型看的、可版本管理的 markdown 行为规范。与一次性 Chat 提示不同，Rules 由宿主在适当时机注入，使「开始做某功能 → 更新任务板 → 建分支 → 按规范改代码」可以稳定复现。

在东哥说AI 的 Trae 实战中，Rules 被明确拆成与 MCP 模型上下文协议 的分工：MCP 解决「能碰外部系统」；Rules 解决「不必每次手动说碰一下」。没有 Rules，接了 Linear MCP 仍要反复喊「标成进行中」；有了语义触发 Rules，自然语言开工即可驱动 Todo→In Progress→Done。

关键信息

核心特性

定义与组成

  • 定义：在 AI IDE 执行前注入上下文的规则与规范文本，引导工具调用、状态同步与编码行为。
  • 核心组成：
    1. 触发方式（何时注入）
    2. 行为条款（注入后必须/禁止做什么）
    3. 工具绑定（可调用哪些 MCP/内置工具）
    4. 术语映射（项目阶段名、任务命名、分支约定）
  • 典型应用：任务管理状态同步、按文件类型加载语言规范、安全红线、提交与分支约定。

注入模式（Trae 素材归纳）

模式含义任务管理场景建议
总是生效每次对话都注入适合短全局红线；长流程规则慎用（占上下文）
按文件类型触发编辑某类文件时注入语言/框架规范；联调铁律篇亦用于「改 .py 才加载某 MCP」
语义自动匹配用户意图匹配规则描述时注入任务管理首选：说「开始做…」即同步 Linear
手动 @ 引用用户显式点名规则偶发流程、重型检查清单

与相邻资产的边界

资产主责与 Rules 关系
MCP外部系统工具面Rules 决定何时调用哪些 MCP
Skill可打包的程序性工作流Skill 偏「怎么做完一类活」；Rules 偏「宿主级持续约束」
AGENTS.md / CLAUDE.md项目编码与协作规矩常可视为 Rules 族的静态/建议性子集
Plan 文档阶段与待办真源之一Rules 可规定「读 Plan → 批量建任务」的行为

常见误区

  1. 手写超长万能模板：项目术语不同，抄来的 Rules 触发词对不上。
  2. 只接 MCP 不写 Rules：停留在点动，体验仍碎。
  3. 总是生效塞进全部流程：上下文被规则挤爆，模型反而丢架构。
  4. 一次写死不迭代：应在真实漏触发/误触发上微调。

不同素材中的观点

  • 2026-07-23-woshipm-mcp-rules-40-tasks：系统提出「MCP + Rules」组合拳。Rules = markdown；任务场景用语义触发。关键经验：别手写、别找通用模板——把 MCP 官方文档 + Trae Rules 规范喂给 AI，说明目标（开始做→In Progress+建分支等），让 AI 生成 Rules，再实战迭代。终态：说「开始做阶段 1…」则自动改看板并推进，人只把握方向。评论：「光有 MCP 还是点动，加上 Rules 才形成闭环」。

  • （交叉）2026-07-23-woshipm-vibe-coding-system-pitfalls：同系列联调篇从反面要求 Rules 大道至简、MCP 按需，并用「按文件类型触发」控制 MCP 加载。与本文「语义触发管任务状态」互补：一种控工具面膨胀，一种控状态同步自动化。

实用信息

  • 快速上手步骤：
    1. 先打通 MCP 冒烟（例如 Linear 建一条任务）
    2. 收集官方 MCP 文档 + 当前 IDE 的 Rules 规范
    3. 用一段目标描述让 AI 生成第一版 Rules（语义触发优先）
    4. 真实项目跑 3～5 个任务周期，记录漏/误触发
    5. 只对反复出错点加规则，避免堆砌
  • 生成 Rules 的提示意图（可改写后使用）：

阅读 @LinearMCP文档 与 @TraeRules规范。生成语义触发 Rules：当用户表示开始做某功能/阶段时，在 Linear 将对应任务设为 In Progress，并创建对应 Git 分支；完成提交后设为 Done。说明命名匹配方式与找不到任务时的行为。

  • 注意事项：
    • 触发词要贴合团队口语（「开始做」「做阶段 3」「领前端任务」）
    • 状态真源与分支命名约定写进 Rules，减少模型自由发挥
    • 与编码向 AGENTS.md 分离关注点：任务状态 Rules 不必塞满 lint 细则

相关页面

关系图谱

快速导航

反向链接