入门 Zed Industries 2026-09-14 17:42:19 · 0 阅读
第25章 Zed Agent 指令配置指南：个人与项目规则
Instructions 是 Zed Agent 的常驻上下文，适用于需要在每次 Agent 交互中持续生效的指导规则。
如果需要使用可通过名称调用的可复用任务指令，请改用 Skills。
Zed 支持 AGENTS.md 作为个人级和项目级 Agent 指导的主要指令文件。
个人指令 {#personal-instructions}
个人指令适用于你用 Zed Agent 打开的所有项目。
创建或编辑：
~/.config/zed/AGENTS.md
在 Windows 上，等效文件位于 %APPDATA%\Zed\AGENTS.md。
项目指令 {#project-instructions}
项目指令文件仅适用于当前项目。Zed 会使用列表中第一个匹配的文件：
.rules.cursorrules.windsurfrules.clinerules.github/copilot-instructions.mdAGENT.mdAGENTS.mdCLAUDE.mdGEMINI.md
若发生冲突，项目指令会覆盖个人 AGENTS.md。
指令文件支持 {#support}
| 文件 | Zed Agent | 外部 Agents | Terminal Threads |
|---|---|---|---|
~/.config/zed/AGENTS.md |
作为个人指令加载 | 通常不使用 | 除非 CLI 读取该文件，否则不使用 |
项目 AGENTS.md |
作为项目指令加载 | 取决于具体的 Agent | 取决于具体的 CLI |
CLAUDE.md |
由 Zed Agent 作为兼容的项目指令加载 | Claude 原生读取 | Claude Code CLI 原生读取 |
.github/copilot-instructions.md |
由 Zed Agent 作为兼容的项目指令加载 | 取决于具体的 Agent | 取决于具体的 CLI |
外部 Agents 和 Terminal Threads 可能会直接读取它们各自的原生指令文件。不要假设 Zed 的指令加载器能控制这些 Agent。
Instructions 与 Skills 的区别 {#instructions-vs-skills}
| 用途 | 适用场景 | 示例 |
|---|---|---|
| Instructions | 持续生效的指导 | 仓库规范、偏好的语气风格、项目约束 |
| Skills | 可复用的任务流程 | 代码审查清单、发布流程、迁移辅助工具 |
从 Rules 迁移 {#migrating-from-rules}
Rules 已被 Skills 和 Instructions 取代：
- 可复用、按需调用的 Rules 改为 Skills
- 默认持续生效的 Rules 改为个人
AGENTS.md - 项目中的
.rules文件仍受支持，作为兼容用的项目指令文件
