跳到正文
FunCoding

搜索

搜索文档、智能体、博客、Skill 和 MCP

AGENTS.md 与技能

Amp 如何读取 AGENTS.md(项目、用户、系统三层与忽略方法),以及技能的创建、安装和加载优先级。

AGENTS.md

Amp 从 AGENTS.md 里读取关于代码库结构、构建/测试命令和约定的指引:

文件内容示例
AGENTS.md(当前目录、父目录和子树)架构、构建/测试命令、内部 API 概览、评审和发布步骤
$HOME/.config/amp/AGENTS.md、$HOME/.config/AGENTS.md个人偏好、设备特定命令
/etc/ampcode/AGENTS.md(macOS 为 /Library/Application Support/ampcode/,Windows 为 %ProgramData%\ampcode\)系统级或组织统一管理的指引

自动包含规则:当前工作目录(或编辑器工作区根)及其到 $HOME 的各级父目录里的 AGENTS.md 始终包含;子树里的 AGENTS.md 在智能体读取该子树里的文件时包含;系统级和个人全局文件始终包含。某目录没有 AGENTS.md 但有 AGENT.md 或 CLAUDE.md 时,改用它。大型多子项目仓库建议顶层保持通用、子树里放更具体的。命令面板里 agents-md list 可以查看正在使用的文件。设置环境变量 AMP_IGNORE_GUIDANCE_FILES(冒号分隔的 glob,匹配绝对路径)跳过指定文件,值为 * 则不加载任何指引文件。若不存在 AGENTS.md,Amp 会主动提出生成;也可以让它「根据这个线程里我说的内容更新 AGENTS.md」。

技能

技能是包含针对特定任务的指令和可选资源的目录。Amp 内置技能(比如 building-skills,能帮你创建或安装技能),你也可以放在项目里、装在本机或发布给自己或工作区。

Create a project skill for deploying this app to staging
Install the skills from github.com/example/engineering-skills

项目技能保存在 .agents/skills/ 可随项目提交;个人技能在所有使用 Amp 的地方可用。命令行安装:amp skill add <来源>(GitHub 仓库、Git URL 或本地路径),加 --global 只装到本机 ~/.config/agents/skills/。同名技能取先找到的,顺序为:~/.config/agents/skills/ → ~/.agents/skills/ → ~/.config/amp/skills/ → 项目及父目录的 .agents/skills/ → 这些目录里的 .claude/skills/ → ~/.claude/skills/ → ~/.claude/plugins/cache/ → amp.skills.path 里配置的目录 → 内置技能 → 个人技能仓库 → 工作区技能仓库。本地技能目录递归搜索,最深到技能根目录下 5 层。可用 amp.skills.disableClaudeCodeSkills 跳过兼容 Claude 的位置,amp.skills.disableGlobalAgentsSkills 跳过全局通用目录。技能里还可以通过 mcp.json 打包 MCP 服务器,只在需要时加载其工具(官方推荐,这样工具列表更干净)。