用途：该技能定义 .github/agents/*.agent.md 代理定义文件所需的结构与最佳实践，用于新建代理文件、审查或重构已有代理定义，以及保证代理生态的一致性。
主要能力与要求：所有代理必须遵循统一结构——顶部 YAML frontmatter 包含 description（不超过100字符）、name（显示名称，需标注代理类型）、model（仅 VS Code 代理，且模型须存在于 docs/ai-model-reference.md）；正文包含 # Agent Name Agent 标题、Your Goal（一句话目标）、Boundaries（✅ Always Do、⚠️ Ask First、🚫 Never Do）、Context to Read（带链接的相关文档）、Workflow（编号步骤）、Output（产出物）。
关键原则：具体优于笼统，命令优于描述（如 npm test、dotnet build），示例优于解释，边界优先。frontmatter 要求：编码代理（*-coding-agent.agent.md）不得包含 model:，否则会触发 CAPIError: 400 The requested model is not supported 导致代理无法运行；不带 -coding-agent 后缀的 VS Code 代理应始终包含 model:。
限制：本资料仅为编写规范说明，未提供安装命令、价格、平台支持范围或实际运行效果等信息。