agents

用途：为项目创建或更新 AGENTS.md，向 AI 编码代理说明代码库情况，统一多仓库的代理文档，检查文档是否与近期代码变更同步。AGENTS.md 面向代理而非人类，重点在于提升代理效率。主要能力：提供脚本完成生成与校验。生成用 scripts/generate-agents.sh PATH；结构校验用 scripts/validate-structure.sh PATH；时效检查用 scripts/check-freshness.sh PATH；验证文档中文件与命令是否匹配代码库用 scripts/verify-content.sh PATH；验证命令能否执行用 scripts/verify-commands.sh PATH；检测语言、版本与构建工具用 scripts/detect-project.sh PATH；识别需要独立范围文件的目录用 scripts/detect-scopes.sh PATH；从构建配置提取命令用 scripts/extract-commands.sh PATH。完整选项参见 references/scripts-guide.md。核心原则：用表格和结构而非长段落；命令必须经过验证；指向文件而非复制内容；提供可效仿的示例文件；生成前先审计现有文档与痛点。默认使用英文，可例外地匹配代码命名语言。使用前提：Bash 4.3+（macOS 可用 brew install bash）、jq 1.5+、git 2.0+。参考文档涵盖验证、脚本、AI 工具兼容、输出结构、真实案例分析、PHP/TYPO3、Go、TypeScript 目录覆盖及完整示例。模板分根级与范围级，如 root-thin.md、root-verbose.md，以及 backend-go.md、backend-php.md、typo3.md、oro.md、cli.md、frontend-typescript.md。支持 Go、PHP、PHP/TYPO3、PHP Oro、TypeScript、Python 及混合多语言项目，混合项目会按技术栈自动创建范围文件。限制：具体效果、收费与平台支持暂未提供。