用途:面向需要创建、重写、检查或优化项目 AGENTS.md 的场景,提供从项目分析到质量验收的行动指南。AGENTS.md 定位为 Agent 的操作手册,回答“如何在此项目中工作”,而非项目说明书;与技能级 SKILL.md 不同,多 Agent 协作环境中优先级为 AGENTS.md > CLAUDE.md > .cursorrules > README.md。
主要能力:包含 6 个子技能——1-analyze-project(项目分析与类型判定)、2-design-structure(结构蓝图设计)、3-write-content(内容编写)、4-select-template(模板选择定制)、5-quality-check(质量检查)、6-optimize-evolve(迭代优化维护)。知识库含 best-practices.md(28条最佳实践)、type-classification.md(5种类型)、anti-patterns.md(22个反模式)、templates.md(最小可行/标准/完整模板)、examples.md(4个真实案例)、token-budget.md(Token预算)。
使用方式:按意图路由触发对应子技能,通用流程为意图识别、信息收集(读取项目上下文如 README/package.json/技术栈)、执行指南、质量门禁、交付成果。可运行 cat AGENTS.md | head -50 查看结构,或 wc -l AGENTS.md && echo "估算Token: $(($(wc -l < AGENTS.md) * 3))" 统计行数与估算 Token。
质量门禁:需通过前言区完整性(name/description/tags)、触发条件明确、意图路由清晰(至少3个触发→执行映射)、无反模式、Token效率合理(核心内容≤500行)等检查。
限制:资料仅给出方法、门禁与命令,未提供具体安装步骤、收费信息、运行平台或实际效果数据;实际输出质量取决于项目上下文完整度与人工复核。