用途：为当前代码仓库生成并维护高质量的 AGENTS.md，并把其他代理工具指向它。AGENTS.md 是跨工具标准，多数编码代理会读取；CLAUDE.md 等通过符号链接指向它。该技能可安全重复运行，只重写自己生成的区域（用 HTML 注释标记），绝不覆盖人工内容。
主要能力：定位仓库根目录（git rev-parse --show-toplevel），检测已有代理文件（AGENTS.md、CLAUDE.md、.cursor/rules/、.cursorrules、.github/copilot-instructions.md、.windsurfrules、GEMINI.md）。从 package.json、pyproject.toml、go.mod、Makefile、Dockerfile、.github/workflows/、README.md、.env.example 等真实来源读取语言、构建/测试/运行/检查命令、结构、Git 工作流、部署与环境信息，不猜测。内容精简（约 200 行以内），命令必须真实复制，找不到就写 TBD 占位。必须包含三档边界：✅ Always、⚠️ Ask first、🚫 Never。
使用方式：按顺序执行——定位仓库并盘点、从仓库收集事实、按模板写内容、安全写入、把其他工具接到 AGENTS.md、报告结果。写入分三种模式：无 AGENTS.md 则创建；有本技能标记则只重生成标记内内容，标记外逐字节保留；无标记的手写文件不动，另写 AGENTS.generated.md 并提示合并。CLAUDE.md 缺失时创建指向 AGENTS.md 的符号链接；已有手写文件需先询问。Windows 或符号链接失败时写一行“See AGENTS.md”的存根。
适用场景：需要为仓库建立统一代理指引、并让多个编码代理共用同一份说明的项目。
限制：不编造命令、端口或规则；只读 .env.example，绝不读取或复制真实密钥；标记外内容与无标记文件不可修改；重复运行是安全刷新而非重置。具体模板细节与完整命令示例暂未提供。