最近在整理AI Agent的配置文件体系,发现一个现象:很多人知道Claude Code、Cursor、Codex这些工具,也知道往对话框里丢prompt,但不知道在这些工具背后还有一套「持久化记忆系统」——CLAUDE.md、AGENTS.md、SKILL.md、.cursorrules。
这些文件说白了就干一件事:让Agent每次打开项目,都知道你是谁、你要什么、你讨厌什么。
这篇文章把我从GitHub、X、知乎、V2EX、YouTube上翻到的、适合中国产品经理的配置资源整理出来了。分三类讲:先搞懂概念,再直接拿走用,最后说说谁值得关注。
你刚接触时最困惑的,无非是这几个文件到底有什么区别。我直接画个表:
| 文件 | 谁来读 | 管什么 | 加载时机 |
|---|---|---|---|
| CLAUDE.md | Claude Code | 项目级行为准则+命令 | 每次会话启动 |
| AGENTS.md | Codex/Cursor/Copilot等60+工具 | 跨工具通用规则(开放标准) | 每次会话启动 |
| SKILL.md | Claude Code/Codex | 按需加载的专业技能 | 需要时才激活 |
| .cursorrules | Cursor | Cursor专用的规则 | 每次会话启动 |
| .mdc | Cursor | 模块化规则文件(可配触发条件) | 按glob匹配自动加载 |
关键点就两个:
CLAUDE.md 和 AGENTS.md 是「常驻记忆」——Agent每次打开项目都读,告诉它项目用什么技术栈、怎么构建、哪些目录不能碰。
SKILL.md 是「技能包」——只有你需要它做某件事时才激活。比如写PRD时加载PRD Skill,不需要时零token成本。
记住一个原则就够了:别让Agent每次冷启动猜你要什么。
我扫了一圈,发现中文社区里已经有人在系统整理这部分内容了,而且质量不低。比直接啃英文README友好得多。
tianpan.co —— CLAUDE.md和AGENTS.md完整指南
这篇是到目前为止我在中文互联网上看到最完整的。从"为什么Agent会失忆"讲起,到CLAUDE.md和AGENTS.md的功能对比,再到指令预算控制——就是那篇说「600行的配置文件反而会让Agent忽略你的实际指令」的出处。作者Tian Pan是前Uber工程师,现在专注Agent工程方向。
CLAUDE Code自己的系统prompt里就写明了——"CLAUDE.md的内容可能与你的任务相关,也可能不相关"。AI主动执行了上下文淘汰,你堆再多行它也在选择性忽略。
termdock.com —— CLAUDE.md撰写指南(5个区块模板)
如果你只想看"怎么写出一个好的CLAUDE.md",这篇就够了。作者给出了5个区块模板:Architecture → Conventions → Constraints → Commands → Patterns,每个区块都有完整示例。还给了token预算参考——30行精简版≈450 token,100行≈1500 token,占到200K上下文的0.75%,这个比例是合理的。
引用ETH Zurich 2026年的研究发现:LLM生成的context文件让任务成功率下降了3%(比不提供还差),人工撰写的也只提升了4%。结论是多数配置写得太烂了——又长又啰嗦。
火山引擎开发者社区 —— AGENTS.md实用指南
字节这边翻译总结的Builder.io创始人分享,实操性很强。核心观点:AGENTS.md就是给AI的"项目说明书",把它当README的AI版本来写——告诉Agent你的代码规范、项目结构、不允许做的操作。
极客时间专栏 —— 上下文的艺术
付费内容但值得提一嘴,专门有篇幅讲CLAUDE.md与AGENTS.md,从实践角度拆解了记忆层级的组织和token预算分配。
Blake Crosley —— AGENTS.md模式(中文版)
这篇厉害在,它不是教你怎么写,而是告诉你哪些写法AI会直接忽略——无命令的散文段落、模糊指令、相互矛盾的优先级、无强制执行的风格指南。作者基于GitHub 2,500个仓库的分析,说"大多数AGENTS.md失败是因为从风格指导开始,却从未涉及命令"。
给你一个反例感受一下:
Be careful with database migrations
Optimize queries where possible
在应用迁移前运行 `alembic check`,如果缺少降级路径则中止
概念搞懂了,下一步就是直接用。以下三个仓库都是中文README,对国内PM特别友好。
laolaoshiren/claude-code-skills-zh
精选200+ Claude Code Skill,其中18个是原创可安装技能,按场景分类(代码审查/文档生成/测试/性能分析等)。最推荐的是zh-code-reviewer(中文代码审查)和refactor-advisor(老项目改造建议)。安装方式也简单——把skill目录复制到~/.claude/skills/就行。
说句实话,这类纯技术类的Skill跟产品经理直接关联不大,但它的意义在于让你知道"Skill文件长什么样、怎么装"。装一个试试手感,然后自己改。
seaworld008/Commonly-used-high-value-skills
289个AI技能,中英文双语README,支持Codex/Claude Code/Hermes Agent/OpenClaw/Cursor。分16个类别,其中「产品与设计」和「知识与项目管理」两个类别跟PM最相关。
这个仓库还有额外价值:它本身就是个Skill分发体系的学习样本——有CI编排、质量检查、安全审计、死链扫描。如果你打算自己维护一套Skill库,直接fork它改。
datawhalechina/hello-agents
DataWhale社区出品的Agent教程,其中「Agent应用开发实践踩坑与经验分享」这篇特别值得看——作者记录了自己做Code Agent项目时踩过的坑,包括"不要上来就堆多层记忆"、"CLAUDE.md越短越好"、"让Linter和测试来约束,别靠prompt"。
这些都是真金白银的经验,比看官方文档管用。
中文资源讲完了,但有几个英文项目确实绕不过去,产品经理专用,没有平替。
product-on-purpose/pm-skills
59个PM专用Skill,基于Triple Diamond框架(Discover→Define→Develop→Deliver→Measure→Iterate),支持Claude Code/Codex/Cursor/Windsurf。
亮点是slash command体系:在对话里直接打/prd写PRD、/user-stories写用户故事、/hypothesis写假设、/opportunity-tree画机会树。每个命令背后就是一个独立的SKILL.md,按需加载。
Apache 2.0协议,商业和个人都免费。这是目前GitHub上PM方向质量最高的Skill库,没有之一。
deanpeters/Product-Manager-Skills
47个PM技能,设计思路很有特色——每个Skill同时服务人类PM和AI Agent。你看了能学会框架的"为什么",Agent看了能执行框架的"怎么做"。收录了OKR写作、JTBD画布、SaaS指标诊断等。
它的CLAUDE.md本身就是一个很值得学习的模板。
aakashg/pm-claude-code-setup
如果你不想装一整套Skill,只想有一个干净的CLAUDE.md,这个项目是最优解。整个CLAUDE.md不到60行,PM身份预设 + 写作规则 + 子Agent角色表。
里面有个概念我特别喜欢:子Agent链。写PRD时说一句"review as Engineer"→Agent瞬间切换工程师视角审查可行性;"review as Skeptic"→切换怀疑者视角挑逻辑漏洞。三次审查,三分钟,一份PRD质量提升一大截。
它还提出了一个数据缺口标记法:[NEED: data from X]——不确定的地方不瞎填,直接标记,让数据说话。
deanpeters/product-manager-prompts
50+ prompt模板,MIT协议。比Skill库更轻量,ChatGPT/Claude通用。覆盖JTBD、用户故事、竞品分析、定位声明等场景。
它的独特之处在于每个prompt的Markdown源码里藏了"隐形注释"——你看不到但它能学。作者在前言里写:这些注释对AI不可见,但它们教你如何跟AI更好协作。
Sachin Rekhi(X: @sachinrekhi)——前LinkedIn产品总监,现在全职做AI Productivity课程。他写的"Claude Code for Product Managers"是目前我见过最详细的PM向Claude Code指南,5个真实workflow(战略审视、竞品定价、客户访谈、数据查询、发布说明),每个都有完整示例。
诺特斯频道(YouTube,繁体中文)——台湾团队做的Claude Code教学,有一期讲「别找神提示词,先学会控制AI工作节奏和上下文」,把/effort、Plan Mode、/rewind、CLAUDE.md等实操讲得很清楚。华人社区里少见的深度实操内容。
知乎专栏 / V2EX——知乎上有人在整理Agent配置文件指南,V2EX上有关于「可路由Skill架构」的讨论。整体内容偏技术,PM专项不多,但作为社区域性的参考值得关注。
不同熟练度有不同的切入方式:
| 你的阶段 | 建议路径 |
|---|---|
| 新手(才装好Claude Code/Cursor) | 先读tianpan.co概念文章 → termdock 5区块模板 → 装aakashg的CLAUDE.md改一改就能用 |
| 进阶(会用Agent但方向老跑偏) | 装pm-skills,试试/prd和/user-stories → 关注Sachin Rekhi看真实workflow |
| 深度(想自己搭一套Skill体系) | fork seaworld008做底子 → 参考deanpeters双目标设计 → 研究pm-skills的slash command链路 |
最后说一句:别掉进"配置越全越好"的坑。
一个600行的CLAUDE.md不会让Agent更聪明,只会让它更困惑。先装1-2个,跑通一个完整流程(比如写PRD),再按需扩展。配置也讲究MVP。
| 资源 | 直达 |
|---|---|
| tianpan.co CLAUDE.md指南 | tianpan.co/zh/blog/2026-02-25-claude-md-agents-md |
| termdock 撰写指南 | termdock.com/zh/blog/claude-md-writing-guide |
| 火山引擎 AGENTS.md 指南 | developer.volcengine.com/articles/7549123386920665130 |
| claude-code-skills-zh | github.com/laolaoshiren/claude-code-skills-zh |
| Commonly-used-high-value-skills | github.com/seaworld008/Commonly-used-high-value-skills |
| hello-agents | github.com/datawhalechina/hello-agents |
| pm-skills | github.com/product-on-purpose/pm-skills |
| Product-Manager-Skills | github.com/deanpeters/Product-Manager-Skills |
| pm-claude-code-setup | github.com/aakashg/pm-claude-code-setup |
| product-manager-prompts | github.com/deanpeters/product-manager-prompts |
| Sachin Rekhi | x.com/sachinrekhi |
以上这些配置资源不是什么黑科技,它们的本质是把产品经理的思维框架——你做决策时考虑什么、优先级怎么排、什么可以做什么不能做——结构化后交给Agent。你不在场的时候,Agent也能按你的方法做事。
你有私藏的好资源,评论区分享一下。