Agent Skills
返回列表
💻

AGENTS.md 项目简报初始化

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a36dc51e/repo-init。

技能介绍

解决多 Agent 记忆维护的漂移问题

在多工具协作的开发环境中,为 Cursor、Claude 等 AI 编码代理分别维护 CLAUDE.md、.cursorrules 等专属记忆文件,极易导致内容重复与状态漂移。本技能旨在建立单一事实源,通过统一的 AGENTS.md 承载项目核心上下文。

冷启动与增量更新的双路径机制

技能提供两条核心执行路径:

  • 冷启动初始化:针对无 AGENTS.md 的新仓库,扫描构建文件与 CI 配置,提取真实命令,生成不超过 200 行的标准简报。
  • 更新优化:针对已有文件的仓库,基于 git diff 识别变更面,将内容标记为 🔴过期、🟡缺失或 🟢准确,产出 diff 式增量补丁,绝不整份覆盖。

适用边界与无状态约束

本技能需明示触发,不会自动运行。生成的 AGENTS.md 必须保持无状态,严禁写入待办或会话状态。文档需保持工具无关,仅允许生成一行 @AGENTS.md 的零内容适配指针,禁止复制实质项目信息。

使用场景

  • 新克隆的仓库首次让 AI 接手开发任务,仓库里没有任何给 AI 的项目说明文档
  • 项目里的安装/构建命令已经从 npm 换成了 pnpm,但 AGENTS.md 还在写 npm
  • 团队同时在维护 CLAUDE.md 和 AGENTS.md,两边内容重复且经常不一致
  • 接手 monorepo 项目,需要在根目录和子包目录分别放置 AGENTS.md 来就近覆盖

适合人员

  • 需要在多个 AI 编码工具之间协作的全栈开发者,希望只维护一份项目说明而不是每个工具各写一份
  • 刚接手陌生代码库的技术负责人,希望 AI 能快速理解项目结构和正确的构建方式
  • 维护 monorepo 的工程平台团队成员,需要在根目录和各子包就近放置上下文说明
  • 发现 AGENTS.md 里的命令失效、与仓库现状不符的开发团队,希望做增量修正而不是重写