用途：创建或更新项目根目录下的 AGENTS.md 文档，使 AI 助手能理解项目规范、范围和结构。触发场景包括用户提到“初始化项目”“创建 AGENTS.md”“生成项目规范文档”“项目规范”“AI 理解项目”等；不用于查看已有 AGENTS.md、创建 README 等普通文档或规则文件。
主要能力：先检查 AGENTS.md 是否存在，不存在则新建，存在则默认补充缺失部分、保留现有内容（用户明确要求完全重写时才覆盖）。随后分析项目结构，识别主要编程语言、允许与禁止修改的目录、工程配置文件及 lint/test/build 脚本、目录结构（最多 4 级）。无法自动识别时询问用户编程语言和禁止修改目录。
生成内容：参考 templates/agents-minimal-template.md，必须包含项目简介、范围、改动检查、交付格式、项目结构、路径格式规范、终端命令能力识别、需要遵守的规则、关键参考等章节。终端命令能力识别章节须保留 .terminal.local.md 优先机制和 yy-detect-terminal 创建/更新机制；若项目缺少 .terminal.local.md 且环境可用 yy-detect-terminal，则先触发该技能创建记录。改动检查章节须基于已识别的工程配置给出确定状态，不写模糊表述，也不建议新增工具链。生成内容只描述“做什么”，禁止出现 Write、Edit、Read、WebFetch 等具体工具名。
保存与初始化：保存前校验终端命令能力识别章节是否包含 .terminal.local.md、yy-detect-terminal 及“执行终端命令前，先读取项目根目录下的 .terminal.local.md”，缺失则从模板修正。若存在 .gitignore 且未包含 AGENTS.LOCAL.md 条目则追加；若 AGENTS.LOCAL.md 不存在则从 templates/AGENTS.LOCAL.example.md 创建，已存在则跳过。
限制：路径使用正斜杠，含空格时加引号；内容保持精简，具体规则放 .agents/rules/ 目录；项目结构说明最多 4 级；默认用中文编写（除非项目文档为英文）；更新时默认保留现有内容。辅助资源包括 examples/input.md、examples/output.md、templates/agents-minimal-template.md。