Agent Skills
返回列表
🤖

仓库 Agent 指南生成器

AI Agent 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/agent-copy。

技能介绍

要解决的问题

当你在多个仓库间切换时，每个项目可能有不同的约定、架构决策和编码规范。团队成员或 AI 助手需要快速理解当前仓库的上下文，但手动编写和同步 AGENTS.md 文档既耗时又容易遗漏关键信息。这个技能解决的是如何自动化生成一份既包含通用规则又包含项目特定信息的 Agent 指南。

工作原理

这个技能的核心能力是将你的全局 Agent 指令与当前仓库的具体情况合并，生成一份完整的 AGENTS.md。

关键步骤：

  • 确认源文件：默认从 $HOME/.codex/AGENTS.md 读取，如果你使用其他工具（如 Claude、OpenCode），可以指定自定义路径
  • 基于仓库实际情况：在写入前扫描现有的 README.md、package.json、目录结构等，确保项目特定内容基于事实而非猜测
  • 保留现有内容：如果仓库已有 AGENTS.md，会先读取并保留有用的项目指南，只更新全局前言部分
  • 生成项目特定尾部：追加 ## Repo-Specific Guide 部分，包含从文件系统检查或用户回答中获取的仓库事实

核心规则：

  • 必须精确复制源文件，不能改写或总结
  • 项目特定内容只能来自实际检查或用户确认
  • 未知信息标记为 TBD，并在实现前询问用户
  • 绝不编造生产凭证、部署状态、数据库架构等信息

适用边界

这个技能专门用于创建或更新 AGENTS.md 文件。它不适用于：

  • 生成其他类型的配置文件（除非你明确要求）
  • 替代代码审查或文档生成工具
  • 处理多仓库同步场景（每个仓库需要单独运行）

注意事项：

  • 如果你的全局指令存放在其他位置，需要显式提供路径
  • 当现有仓库指令与全局源文件冲突时，默认遵循全局源文件的规则
  • 仅在用户明确要求时才执行 commit 或 push 操作

使用场景

  • 接手新项目时，需要为当前仓库快速生成一份包含通用规范和项目说明的 AGENTS.md
  • 使用 Codex 等 AI 编程助手时，希望将个人全局指令复制到当前项目的 AGENTS.md 中
  • 团队协作中，需要在仓库根目录维护一份统一的 AI Agent 行为指南文件
  • 项目迭代时，已有 AGENTS.md 需要更新项目特定内容但保留全局前言部分

适合人员

  • 需要在多个代码仓库间切换的开发者，希望 AI 助手快速理解每个项目的特殊约定
  • 使用 AI 编程助手的独立开发者，希望将个人编码规范同步到各个项目中
  • 负责团队代码规范的技术负责人，需要为每个仓库配置统一的 AI 行为指南
  • 在开源项目中维护文档的志愿者，希望简化 AGENTS.md 文件的创建和更新流程