用途：把导出的智能体文件（.af）发布到 letta-ai/agent-file 仓库，供他人使用。
必要输入：一个导出的 .af 文件；一张头像图片（PNG、JPG、WebP 等常见格式，无需正方形）；Owner ID（带 @ 前缀的 GitHub 用户名，如 @letta-ai）；Agent key（小写、连字符分隔、URL 安全的名称，如 loop）。
主要步骤：
- 创建目录 agents/@{owner}/{agent-key}/。
- 将 .af 文件复制并重命名为 {agent-key}.af，文件名须与 agent key 完全一致。
- 处理头像：运行脚本 .skills/releasing-agentfiles/scripts/process-avatar.sh <input-image> agents/@{owner}/{agent-key}/{agent-key}.webp。脚本会检测尺寸、用左上角像素作背景色补齐短边、已是正方形则跳过，并转为 webp（质量 90），依赖 ImageMagick（brew install imagemagick）。若背景不均匀，可手动指定背景色：magick input.png -gravity center -background "#1a1a2e" -extent 500x500 -quality 90 output.webp。
- 可选但推荐添加 README.md，说明智能体功能、特色、训练方式、示例交互及所用工具或集成。
- 校验结构：目录须包含 {agent-key}.af（必需）、{agent-key}.webp（必需，正方形）、README.md（可选）；确认文件名匹配、webp 为正方形（可用 sips -g pixelHeight -g pixelWidth 或 magick identify 验证）、.af 为有效 JSON，且不含敏感数据（API 密钥、个人信息），详见 agents/CONTRIBUTING.md。
- 清理仓库根目录的工作文件，仅保留 agents/@{owner}/{agent-key}/ 内文件。
- 提交：git add agents/@{owner}/{agent-key}/ 与 git commit -m "feat: add @{owner}/{agent-key}"。
限制：需具备 ImageMagick 环境；隐私审查、脱敏与 PR 流程参见 agents/CONTRIBUTING.md。