规则与技能

规则

Auggie 自动从多个文件位置加载自定义规则与指南，让它理解项目约定、编码标准和偏好。按优先级顺序：

1. 自定义规则文件（--rules /path/to/custom-rules.md）；
2. CLAUDE.md（与 Claude Code 等工具兼容）；
3. AGENTS.md（与 Cursor 等工具兼容）；
4. 工作区指南 <workspace_root>/.augment-guidelines；
5. 工作区规则目录 <workspace_root>/.augment/rules/（递归搜索 .md 文件）；
6. 用户规则目录 ~/.augment/rules/（递归搜索，对所有工作区生效）。

用户规则适合个人偏好和跨项目的风格；工作区规则存在项目仓库里，可通过版本控制与团队共享。规则用 Markdown 自然语言编写（如代码风格、架构、测试、依赖几节）。.augment/rules/ 里的文件支持 YAML frontmatter：type 取 always_apply（默认，内容自动包含进每条用户提示）或 agent_requested（按 description 在相关时自动附加，此类型必须写 description）。CLI 的这两个类型与 IDE 扩展里的显示名称有对应关系。

技能

技能遵循 agentskills.io 规范，是模块化的指引、资源和工作流包：专业领域知识、上下文资源、分步工作流、工具使用指南。与规则的区别：技能可被发现（智能体能通过元数据看到有哪些技能）、模块化、标准化（跨 AI 工具兼容）。技能是 SKILL.md 文件，放在 .augment/skills/、.claude/skills/ 或 .agents/skills/（工作区或主目录），每个技能在自己的子目录里。frontmatter 必填：name（1 到 64 个字符，仅小写字母、数字、连字符，不能以连字符开头或结尾、不含连续连字符，必须与目录名一致）和 description（1 到 1024 个字符，说明技能做什么、何时使用）。

name: python-testing
description: Best practices for writing and running Python tests with pytest

# Python Testing Skill
This skill provides guidance on writing effective Python tests.