规则与 Skills
Warp 的全局规则与项目规则(AGENTS.md)、/init 与外部规则文件链接,以及 Skills 的发现、调用与文件格式。
规则
Rules 让你创建可复用的指南,影响智能体如何回应你的提示,使回答更贴合你的编码标准、项目约定和个人偏好。两类:全局规则适用于所有项目和上下文(编码标准、工作区范围的指南、想处处生效的工具偏好;Warp 也可能根据你的使用模式建议全局规则);项目规则存在代码库里、在该项目内工作时自动应用,保存在 AGENTS.md(向后兼容也认 WARP.md),可放在仓库根目录,也可放在子目录做更有针对性的指导。文件名必须全大写才会被识别(AGENTS.md,不是 agents.md),新项目建议创建 AGENTS.md。你在某个目录时,Warp 自动应用根目录和当前目录的 AGENTS.md;编辑其他子目录里的文件时会尽力包含该子目录的规则文件。创建:全局规则——Warp Drive 的 Personal > Rules > Global 面板,或在 Auto/Agent 输入模式用 /add-rule;项目规则——在目录里用 /init(开始索引代码库或显示索引状态、生成带初始上下文的 AGENTS.md,或把已有规则文件链接到 AGENTS.md);/open-project-rules 在 Warp 代码编辑器里直接打开项目规则。可链接的外部规则文件:CLAUDE.md、.cursorrules、AGENT.md、GEMINI.md、.clinerules、.windsurfrules、.github/copilot-instructions.md。多条规则同时适用时有优先级顺序(见官方 Rules precedence)。
Skills
Skills 是可复用、可分享的指令,智能体执行任务时可以调用;把常用工作流、编码模式或领域专长封装成技能文件,智能体自动发现并使用。特点:可复用指令、项目和全局作用域、自动发现、简单的 Markdown 格式(带少量元数据)、可随附脚本和模板、用 /{skill-name} 斜杠命令直接调用、参数化技能(用参数占位符做动态模板)。工作方式:开始智能体对话时,智能体收到所有可用技能的名称和描述列表;判断某技能有助于任务时加载完整指令并照着做。技能发现基于当前工作目录:在 Git 仓库里,包含从当前目录到仓库根的所有技能;项目 A 里看不到项目 B 的技能。同名冲突:自然语言调用时智能体收到所有范围内技能的列表;斜杠命令时优先主目录(全局)技能,然后是更靠近仓库根的上层目录技能。调用示例:「Use the deploy skill to push to staging」或 /deploy。文件格式:带 YAML frontmatter 的 Markdown,必须有 name(唯一标识,通常 kebab-case)和 description(说明技能做什么、何时使用):
---
name: your-skill-name
description: Brief description of what this skill does and when to use it
---
(技能指令正文)