BuildAgent 是一个按 forge 约定创建、校验和审计智能体定义的技能。智能体本质是带 frontmatter 的 Markdown 文件，可通过 install-agents 部署到各供应商目录。它按触发词路由到三条工作流：创建（create agent、new agent、build agent）、校验（validate agent、check agent）、审计（audit agents、check all agents）。
约定方面，智能体标识统一用 PascalCase，不加空格、连字符或缩写；文件名、部署文件名、subagent_type 保持一致。模块智能体使用扁平 frontmatter（name、description、version），模型与工具配置放在 defaults.yaml，并按 fast/strong 语义档位映射到具体模型。正文建议以引用摘要开头，包含 Role（2-3 句）、Expertise（4-6 项）、编号且可执行的 Instructions、Output Format 与 Constraints，总长约 50-80 行；示例必须使用合成数据，不得含真实 PII。
创建流程依次为理解角色与工具需求、选择存放位置、检查命名冲突、编写文件、部署与验证。校验流程检查 frontmatter 命名与描述模式、正文结构、约束与长度是否符合约定，输出 COMPLIANT 或 NON-COMPLIANT。审计流程扫描全部智能体，逐项核对并检查重名、命名规范以及 defaults.yaml 名册与模型工具是否一致，最后给出汇总与修复建议。
部署使用 install-agents，支持 make install-agents 或 lib/bin/install-agents agents --scope user。不同供应商格式不同（Claude/Gemini/OpenCode 用 .md，Codex 用 .toml），部署会添加 synced-from 头以便溯源。限制与注意：供应商需在 providers: 段中配置才会部署；已存在且无 synced-from 头的文件会被跳过以免覆盖用户智能体；改名迁移时需先删除旧文件再运行 make install-agents；模型与工具配置不得写在智能体 frontmatter 中。其他细节暂未提供。