2026 年现在的 Harness/Skills/Rules 结构，主流就是把 Skills 和 Rules 放到 .agents/（或工具专属的 .cursor/、.claude/ 等）目录里。
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/ | 不需要 | 较轻量 |
评论
还没有评论，来发第一个吧