用途:在目标文件夹内生成一份聚焦的 CLAUDE.md,并创建指向它的 AGENTS.md 符号链接,为后续智能体(Claude Code、Codex 等)提供全局 CLAUDE.md 未覆盖的文件夹级上下文。
主要能力与流程:
- 确认目标文件夹(使用工作区根目录下的绝对路径),并判断是否值得建文件——仅当该文件夹存在跨多次会话所需的上下文(持续演进的工作、特定约定、进行中的决策)时才创建;静态参考文件目录不需要。
- 用 ls -la 枚举文件,完整阅读文件夹内每个 markdown、配置和关键源文件,不跳读。
- 先给出按章节分组的候选内容要点清单供用户反馈,候选章节包括:产品/目的、受众、关键文件、约束(MUST NOT)、约定、已锁定决策、背景、与该用户的协作方式、营销角度、核心洞察。
- 与用户迭代,用户直接在 IDE 中编辑后需重新阅读并指出矛盾、错别字、缺失规则或错误归类,未经要求不还原其修改。
- 写入 <folder>/CLAUDE.md,以一行说明文件用途开头;若为子目录文件则先写 Apply root CLAUDE.md first, then this file.;使用 ## 章节标题,多用短要点;跨文件夹引用用 @relative/path/file.md 导入语法;重参考文档标注 Read when: 触发条件。
- 创建符号链接:cd <folder> && ln -s CLAUDE.md AGENTS.md,并用 ls -la CLAUDE.md AGENTS.md 验证。
- 仅在用户要求时提交:git add -A,使用 Day N: 风格消息提交并推送。
规则与限制:不得编造内容,每条要点须可追溯到所读文件或用户所述;保持简洁;仅限文件夹范围,不重复全局 CLAUDE.md;不写文件树、目录清单或代码已体现的技术栈细节;硬性 MUST NOT 放约束、通常做法放约定;避免无例外的绝对规则;不自动摘要或缩短文件;用户纠正后立即补充规则;除用户使用外不加表情符号(状态标记 ✅ 🟡 除外);AGENTS.md 必须是符号链接而非副本;发现用户编辑引入矛盾时主动指出。资料未提供具体收费、平台支持范围等信息。