Harness/Skills/Rules 结构

2026 年现在的 Harness/Skills/Rules 结构，主流就是把 Skills 和 Rules 放到 .agents/（或工具专属的 .cursor/、.claude/ 等）目录里。

my-project/                  ← 项目根目录
├── AGENTS.md                ← 最核心！Agent 的“宪法”（规则、约束、项目概览）
├── .agents/                 ← 新标准目录（跨工具通用）
│   └── skills/              ← Skills 全放这里（每个 Skill 是一个子文件夹）
│       ├── prepare-pr/      ← 示例 Skill
│       │   ├── SKILL.md     ← 必须的文件（YAML 前言 + Markdown 指令）
│       │   ├── scripts/     ← 可选：可执行脚本
│       │   ├── references/  ← 可选：参考文档
│       │   └── assets/      ← 可选：模板/资源
│       └── another-skill/
│           └── SKILL.md
├── .cursor/                 ← Cursor 专用（如果用 Cursor）
│   ├── rules/               ← Rules 全放这里（.mdc 或 .md 文件，可 glob 匹配）
│   └── skills/              ← Cursor 也支持这里（和 .agents/skills/ 并存）
├── docs/                    ← 推荐（Codex 重度使用）：详细知识库
│   ├── design-docs/
│   ├── exec-plans/
│   └── references/
├── BLUEPRINT.yaml           ← 可选：架构蓝图（部分 Harness 用）
└── mcp_config.json          ← 可选：工具连接协议配置

text

my-project/                  ← 项目根目录
├── AGENTS.md                ← 最核心！Agent 的“宪法”（规则、约束、项目概览）
├── .agents/                 ← 新标准目录（跨工具通用）
│   └── skills/              ← Skills 全放这里（每个 Skill 是一个子文件夹）
│       ├── prepare-pr/      ← 示例 Skill
│       │   ├── SKILL.md     ← 必须的文件（YAML 前言 + Markdown 指令）
│       │   ├── scripts/     ← 可选：可执行脚本
│       │   ├── references/  ← 可选：参考文档
│       │   └── assets/      ← 可选：模板/资源
│       └── another-skill/
│           └── SKILL.md
├── .cursor/                 ← Cursor 专用（如果用 Cursor）
│   ├── rules/               ← Rules 全放这里（.mdc 或 .md 文件，可 glob 匹配）
│   └── skills/              ← Cursor 也支持这里（和 .agents/skills/ 并存）
├── docs/                    ← 推荐（Codex 重度使用）：详细知识库
│   ├── design-docs/
│   ├── exec-plans/
│   └── references/
├── BLUEPRINT.yaml           ← 可选：架构蓝图（部分 Harness 用）
└── mcp_config.json          ← 可选：工具连接协议配置

Skills：必须是文件夹（不是单个 MD），里面至少有一个 SKILL.md（带 YAML 前言：name、description 等）。

Rules（Cursor 特有）：放在 .cursor/rules/，每个规则是一个 .mdc 或 .md 文件，支持路径匹配（glob）。

AGENTS.md：根目录必备，可在子模块里再放子 AGENTS.md（层级继承，Agent 会自动读取）。 .agents/ 是跨工具最推荐的目录（Codex、Cursor、Claude 都优先识别它）。

工具	AGENTS.md 位置	Skills 位置	Rules 位置	备注
OpenAI Codex	项目根 + 子目录（层级）	`.agents/skills/`	不需要（用 AGENTS.md）	最简洁，docs/ 重度使用
Cursor	项目根（可选）	`.agents/skills/` 或 `.cursor/skills/`	`.cursor/rules/`（.mdc 文件）	Rules 支持智能匹配 + 手动触发
Claude Code	项目根（CLAUDE.md 也行）	`.claude/skills/` 或 `.agents/skills/`	用 AGENTS.md	喜欢 CLAUDE.md 别名
GitHub Copilot	项目根	`.github/skills/`	不需要	较轻量

评论