基线与条件规则

规则是 Markdown 指令，可从会话开始一直存在，也可等工具触及相关文件才加入。条件规则能减少不相关任务携带的上下文。

位置

用户规则在 ~/.qwen/rules（或 QWEN_HOME/rules），项目规则在 .qwen/rules，活动扩展可提供 rules/。递归发现 .md 文件，包含子目录，顺序确定。

项目规则受工作区信任控制；用户和已安装活动扩展规则不以同样的项目信任门控。

paths 条件

---
description: TypeScript component conventions
paths:
  - "src/**/*.tsx"
---

Place component tests beside the component. Keep local state local unless the feature requires sharing it.

有 paths 的规则在读/编辑匹配文件前不入提示，首次触及后注入一次，保留到本会话余下时间。无 paths 或无 frontmatter 是基线规则，从首请求起作为系统提示，每轮都携带正文。

glob 对项目根相对路径匹配，所有平台用正斜杠，匹配点文件；symlink 会解析，使用链接或真实路径都能命中。正文 HTML 注释发送前剥离。

扩展规则

扩展规则必须带 paths。无条件扩展规则被跳过并在启动警告中点名，避免把扩展全部说明长期塞进每次请求。

提示中按扩展所有者标识来源，例如 charts:rules/charting.md。扩展本身已经通过安装启用，所以这类规则不因项目未信任而关闭；项目规则仍受信任控制。

与其他指令载体配合

Skill 也可按 paths 隐藏初始目录项。规则用于文件范围的约束，Skill 用于模型选择执行的流程，两者不能简单互换。