用途：在创建或修改 AI 智能体（agent）定义文件时应用统一的约定与校验规则，保持智能体目录规范一致。
主要能力：提供新建智能体的脚手架；规定必需的 YAML frontmatter 字段（name、description）与可选字段（tools、disallowedTools、model、permissionMode、maxTurns、skills、mcpServers、memory、hooks）；规定命名使用 kebab-case 且文件名需与 name 一致；要求新增或修改智能体时同步更新同目录 README.md 索引表（按名称字母排序）并补充说明段落；正文使用祈使语气，单个智能体保持单一职责，系统提示控制在 500 行以内。
使用方式：新建智能体执行 python skills/agent-conventions/scripts/scaffold_agent.py <name>；校验执行 python skills/agent-conventions/scripts/check.py，frontmatter 变更后执行 python scripts/validate_agent.py --check-index；无参数时显示约定摘要，check 参数仅运行校验。
适用场景：在 ~/.{gemini|copilot|codex|claude}/agents/、.claude/agents/ 或项目本地智能体目录中维护智能体定义。
限制：不针对 skills、MCP 服务器或 CLAUDE.md；memory 入口文件建议 200 行以内，超出会在加载时截断；应避免重复已有智能体功能。