DevBoxPicks创作者的工具箱
AI 编程 / TOOL NOTES

AI 编程助手约定模板包

面向中文开发者的 AGENTS.md / CLAUDE.md / Cursor / Copilot / Cline 约定模板包：一份正文，其余文件只做薄导入或薄映射，避免多工具副本漂移。

免费Windows / macOS / Linux
访问官方入口

官方资料整理 · 尚未设备实测。安装步骤为入门建议，请结合当前官方文档使用。

本条为本站自有原创资源，非第三方软件，不涉及他人著作权，采用 CC BY-NC 4.0 授权。文件为 8 个 Markdown / MDC 文本模板（约 23 KB），整理于 2026-10-17。核对对象是各工具的官方文档，未在工具中做过导入实测，因此未标记实测与评分。下载入口由作者本人上传至网盘；本资源没有独立的官方网站或代码仓库。

它能帮你做什么

同时用多个 AI 编程助手的人都会遇到同一件事：项目约定要分别塞进 AGENTS.md、CLAUDE.md、.cursor/rules/、.github/copilot-instructions.md、.clinerules/……而这些工具的文件名、目录、frontmatter 字段各不相同，又都在频繁变动，凭记忆写几乎一定会写错其中一个。

本模板包的做法是只用一份正文：AGENTS.md 承载全部项目约定，其余文件只放「只对该工具生效」的少量补充或导入语句。包内附一张读取约定对照表，逐行标注核实日期与官方依据来源，并明确列出未核实项。整理时间 2026-10-17。

包含 8 个文件：README.md（已核实读取约定对照表、安装步骤、诚实限制、来源清单）、AGENTS.md（唯一正文）、CLAUDE.md（导入 AGENTS.md 的薄文件）、GEMINI.md、copilot-instructions.md，以及 cursor/ 与 cline/ 下的路径级条件规则示例。

需要说明的是：本包核对的是各工具的官方文档，没有在全部工具中逐个做「放进文件→启动工具→确认被读取」的导入验证；这个领域的约定每月都在变，请在使用前复核官方文档，以工具实际行为为准。

一份 AGENTS.md 正文 + 8 个文件的薄导入/薄映射结构覆盖 Claude Code、Cursor、GitHub Copilot、Cline、Aider、Gemini CLI、Windsurf（现 Devin Desktop）、Codex、opencode、Zed 的读取位置读取约定对照表逐行标注核实日期与官方依据 URL含 Cursor .mdc（alwaysApply 与 glob 两种模式）和 Cline paths 条件规则示例单独一节写「诚实限制」与未核实项，不夸大覆盖范围

适合谁

  • 同时使用多个 AI 编程助手、约定需要反复同步的中文开发者
  • 希望给项目立一份可执行约定文档的独立开发者与小团队

选择之前，了解两面

值得考虑

  • 只用一份正文，避免多工具副本各自漂移
  • 每个工具的读取位置都附官方依据与核实日期，而不是凭记忆
  • 明确列出未核实项（Codex 官方页、Zed/opencode 细节、Antigravity CLI）

需要留意

  • 核对的是官方文档，未在全部工具中做导入实测
  • 工具约定变动频繁，2026-10-17 的快照会过期，使用前需复核
  • 正文中的具体条款是占位符，必须按项目改写，原样提交没有意义

从一个小任务开始

安装入口与准备

从网盘转存并下载后解压，把 AGENTS.md 放到仓库根目录。按 README 第一节的表格按需补充：Claude Code 需要根目录 CLAUDE.md（它导入 AGENTS.md）；需要路径级规则时把 cursor/*.mdc 复制到 .cursor/rules/、cline/*.md 复制到 .clinerules/；Copilot 仓库级指令把 copilot-instructions.md 复制到 .github/copilot-instructions.md；Aider 在 .aider.conf.yml 里加 read: AGENTS.md。

第一次使用

把 AGENTS.md 里所有方括号占位内容替换成你项目的真实约定，与项目无关的整段直接删掉，建议控制在 200 行以内。改完在你要用的工具里打开该项目，确认规则被读到；之后约定变更只改 AGENTS.md，其余薄文件基本不用动。Cursor 的 .mdc 需要保留 frontmatter 的 description/globs/alwaysApply 三个字段，扩展名必须是 .mdc。

环境要求

任意操作系统（Windows / macOS / Linux）；只需要能编辑纯文本文件；Git 可选，若要提交到仓库建议先确认这些文件不会被其他工具的生成流程覆盖。

价格与授权

本站自有原创作品，免费转存使用，不设付费墙。采用 CC BY-NC 4.0 授权：非商业使用自由，署名需保留；商业使用需另行取得许可。

CC BY-NC 4.0（署名—非商业性使用 4.0 国际）

常见问题

这份模板包是软件吗？

不是。它是一组 Markdown / MDC 文本模板文件，没有可执行程序，也不安装任何东西。解压后直接复制到你的项目里使用。

为什么只保留一份 AGENTS.md，而不是每个工具各写一份？

同一份约定抄成多份正文，改一处忘一处之后必然漂移，而且你无法判断工具实际读的是哪一份。本包让 AGENTS.md 承载全部正文，其余文件只做导入或少量工具专属补充。

包里的工具清单会过期吗？

会。核对日期是 2026-10-17，README 已标注这个领域变动频繁（整理期间就发现 Gemini CLI 已过渡到 Antigravity CLI、Windsurf 已改为 Devin Desktop、规则目录首选 .devin/rules/）。使用前请复核官方文档。

有没有做过「放进文件后工具确实读到了」的验证？

没有做全量导入验证。本包核对的是各工具的官方文档，不是运行时行为；README 第四节列了未核实项。若工具行为与文档不符，以工具实际行为为准。

实测记录

记录只适用于下列环境、版本和任务；结果包含失败或部分符合，不代表全部功能已验证。资料来源核查另列在下方。

尚无完成的实测记录，暂不提供实测结论或评分。

资料来源

  • agents.md跨工具标准站，含支持清单与 Aider／Gemini CLI 配置说明 · 2026-10-17
  • docs.claude.comClaude Code 记忆与规则读取顺序、@ 导入层数限制 · 2026-10-17
  • cursor.comCursor 规则扩展名必须为 .mdc，frontmatter 三字段含义 · 2026-10-17
  • docs.github.comCopilot 仓库级与路径级指令文件位置及 applyTo · 2026-10-17
  • docs.cline.botCline 规则目录与 paths 条件规则 · 2026-10-17
  • aider.chatAider 约定文件默认命名与加载方式 · 2026-10-17
  • github.com含 Gemini CLI 过渡到 Antigravity CLI 的官方公告 · 2026-10-17
  • docs.windsurf.comWindsurf／Devin Desktop 规则与 memories 限制 · 2026-10-17