用途
该技能用于在某个目标文件夹内生成聚焦的 CLAUDE.md，并创建一个指向它的 AGENTS.md 符号链接。其目的是为未来在该区域工作的智能体（Claude Code、Codex 等）提供全局 CLAUDE.md 未覆盖的文件夹级上下文。
适用时机：用户要求文件夹专属的智能体指令或本地上下文文件时；某个子目录需要为未来智能体准备 CLAUDE.md 与 AGENTS.md 交接时。
主要能力
- 在目标文件夹内生成聚焦的 CLAUDE.md。
- 创建指向 CLAUDE.md 的 AGENTS.md 符号链接。
- 按分区组织内容，候选分区包括：Product / Purpose、Avatar / Audience、Essential Files、Constraints (MUST NOT)、Conventions、Locked Decisions、Context、How to work with the user、Marketing Angles / Positioning、Top Insights。
- 支持跨文件夹引用，使用 @relative/path/file.md 导入语法。
- 对重型参考文档标注 Read when: 触发条件，避免每次会话都加载。
使用方式（流程）
- 确认目标文件夹并判断是否值得创建文件：向用户询问文件夹；使用用户授权的绝对路径，不假设上游作者的主目录布局。仅当文件夹具有跨多个会话所需的上下文（活跃演进的工作、特定约定、持续决策）时才创建。静态参考文件目录不需要。不确定时询问用户。
- 完整阅读文件夹内每个文件：先用 ls -la 枚举文件与子文件夹；阅读每个 markdown、配置和关键源文件；对大型 tldraw/Vite 子项目，阅读 package.json、src/App.tsx、一个代表性模块文件以及该文件夹自身的 module-details.md 类文件。不要略读，不要跳过。
- 起草候选内容要点列表：写入文件前，按分区给出要点列表供用户先反馈。
- 与用户迭代：保持回答简短；用户会直接在 IDE 中编辑。用户编辑后重新阅读并标记矛盾、拼写错误、缺失规则、错误分类。除非被要求，不要回退其编辑。
- 写入文件：路径为 <folder>/CLAUDE.md；以一行说明文件用途的标题开头；若为子目录文件（父文件夹已有自己的 CLAUDE.md），开头写 Apply root CLAUDE.md first, then this file.；使用与用户批准分区一致的 ## 标题；多用短要点而非长段落；跨文件夹引用使用 @relative/path/file.md 语法；重型参考文档用 Read when: 标注。
- 创建 AGENTS.md 符号链接：cd <folder> && ln -s CLAUDE.md AGENTS.md，并用 ls -la CLAUDE.md AGENTS.md 验证。
- 仅在用户要求时提交：除非用户明确要求，不要暂存或推送；被要求时仅用显式路径暂存已审阅的指令文件，遵循仓库提交约定，且仅在获授权时推送。
规则要点
- 绝不编造内容，每条要点须可追溯到文件夹中读到的内容或用户所述，不使用通用模板。
- 简洁优先，从紧凑开始。
- 仅限文件夹范围，不重复全局 CLAUDE.md（个性、日期、端口等）。
- 不写文件树、目录清单或代码已体现的技术栈细节；固定决策、规则与上下文，而非结构。
- 区分 Constraints（硬性 MUST NOT 否定规则）与 Conventions（通常做法）。
- 无明确例外时不使用绝对的 ALWAYS/NEVER。
- 绝不总结或自动缩短文件；如需精简由人工完成。
- 维护循环：仅当指令文件维护在用户授权范围内时才持久化修正。
- 除非用户使用，否则不加 emoji（状态标记 ✅ 🟡 例外）。
- 客户端兼容同步：先检查现有 AGENTS.md/CLAUDE.md 及客户端符号链接/导入行为；不自动替换任一文件或悬空链接；仅在支持且获批准时使用符号链接，否则保持分别限定范围的指导一致。
- 诚实标记缺口：若用户编辑引入矛盾，主动指出。
适用场景
- 用户要求为某文件夹创建专属智能体指令。
- 子目录需要为未来智能体准备 CLAUDE.md 与 AGENTS.md 交接。
- 需要将文件夹级约定、约束与已锁定决策固化下来。
限制
- 改编自 davidondrej/skills；执行前需验证本地路径、工具、凭据与智能体功能。
- 对于命令、远程访问、调度、浏览器自动化或改文件工作流，需获得用户明确批准并先确认目标环境。
- 背景参考库 library/claude-code/claude-and-agents-md.md 未随此目录副本打包。
- 关于收费、价格、平台支持范围等具体信息，资料中暂未提供。