用途:该技能用于指导创建 agents.md 文件,为 AI 编程助手提供项目专属的上下文信息。这是最简格式:仅纯 Markdown,无 YAML frontmatter,无特殊语法。
格式要求:纯 Markdown;禁止 frontmatter;内容自由组织,无必需结构;通常是项目根目录下的单个 agents.md 文件。也可在 monorepo 的各子包目录中放置各自的 agents.md。
建议包含:项目概览与目标、架构决策与模式、技术栈与依赖、文件结构、编码规范、开发工作流、测试方法、领域知识与业务逻辑。应跳过 AI 已知的通用编程实践、语法讲解、框架基础与显而易见的代码质量规则。
写作风格:保持简洁,聚焦项目特有约定,给出真实代码模式;同时面向 AI 与人类开发者,保持可读性。示例涵盖任务管理应用、支付网关 API、前端组件库等场景,涉及技术栈、API 设计、错误格式、安全、数据库约定、组件结构与无障碍等主题。
常见错误:添加 YAML frontmatter(禁止);写通用最佳实践;冗长解释;语言教程;缺少业务上下文。
从其他格式迁移:删除全部 frontmatter,仅保留 Markdown 内容,合并多个规则文件,移除 globs、regex 等格式特有功能。
验证:资料给出文档与 schema 的本地路径,以及官方规范地址 https://github.com/openai/agents.md。具体命令、安装步骤与收费信息资料未提供。