QWEN.md 与个人项目指令
放置用户、项目及本地指令,使用导入并核对实际加载内容。
This page has not been translated into English yet. The original Chinese version is shown below.
QWEN.md 保存每次任务都需要的长期约定,例如构建/测试命令、团队代码规范、架构约束和个人偏好。内容应短而具体,不必重复从代码即可查到的所有事实。
放在哪里
| 文件 | 范围 |
|---|---|
| ~/.qwen/QWEN.md | 当前用户的所有项目 |
| 项目根 QWEN.md | 团队共享,可纳入版本控制 |
| .qwen/QWEN.local.md | 当前用户在此项目的个人约定 |
三者可一起使用,本地 QWEN.local.md 在共享项目文件之后加载,可补充或覆盖其指令。仓库已有 AGENTS.md 时也会读取,不必为工具重复两份相同规则。
QWEN.local.md 可放个人调试命令、自己的环境标识或未共享工作笔记。Qwen 不自动生成 gitignore,需自行忽略该文件:
.qwen/QWEN.local.md生成与导入
/init 分析项目生成初始 QWEN.md;已有文件时建议补充,不直接覆盖。检查生成的命令是否符合项目当前环境,再长期保留。
Use the project conventions in @docs/conventions.md.
See @README.md for build and test commands.导入相对路径从 QWEN.md 自身位置解析,不是从任意调用工具的目录解析。只有实际存在的文件才应作为引用。
核对是否生效
/memory 显示加载文件并可打开个人/项目 QWEN.md。文件未列出时,不应假定模型已看到它;核对位置与当前工作区。
将“代码写好一点”改成“TypeScript 使用两空格缩进”这样的可操作要求,检查不同层有无冲突。文件加载可提供稳定上下文,但不能保证模型每次都正确执行全部指令。