agents-md-author

用途：根据当前项目结构引导或更新项目级 AI 代理指令文件，生成 AGENTS.md（适用于 Codex 及多数工具）、CLAUDE.md（适用于 Claude Code），或两者同步维护，便于同一份项目约定在多种工具中使用。\n\n主要能力：先检测项目上下文，包括项目名称、语言与运行时、常见脚本、测试框架和仓库约定，再按规范结构撰写内容。结构含项目名称与一句话描述、技术栈、开发命令（安装、开发服务器、构建、测试、检查/类型检查）、代码约定、架构说明以及 AI 代理不应触碰的范围。\n\n使用方式：用户请求“写 AGENTS.md”“创建 CLAUDE.md”或为 AI 设置项目指令时激活。仅需 Codex 时写 AGENTS.md，仅需 Claude Code 时写 CLAUDE.md，两者同步时写内容一致的 AGENTS.md 与 CLAUDE.md，或让 CLAUDE.md 仅指向 AGENTS.md；也可用 AGENTS.md 加符号链接作为单一来源。写入前若文件已存在，先读取、提出差异并征得用户同意，避免直接覆盖。\n\n适用场景：为新 AI 工具接入已有仓库并沉淀约定，或让项目文档兼容 Codex、Claude Code、Cursor 等遵循 AGENTS.md 约定的工具。\n\n限制：文件建议控制在约 150 行以内，避免冗长被代理跳过；需使用规范行尾，不添加总结或“生成者”页脚；具体规范细节可加载 references/agents-md-spec.md。其余细节暂未提供。