Yixiaoer Bootstrap

蚁小二CLI安装助手

以下步骤面向 AI Agent。这个 bootstrap skill 只负责安装 yxer CLI 和正式 yixiaoer skill；安装、升级、同步完成后应停止，不继续执行发布、账号查询、素材上传或 payload 校验。

核心原则

1. Agent 优先 让 AI Agent 调用 CLI 完成自媒体自动化发布、校验、查询等操作。
2. 流程标准化 将账号确认、素材上传、字段校验、一键发布变成固定流程。
3. 多平台适配 按平台真实字段执行，支持抖音自动发布、视频号自动发布、小红书自动发布等不同平台不同场景的分发规则。
4. 素材统一管理 图片、视频、封面先上传，再用于自媒体多平台内容发布。
5. 先校验后分发 自媒体平台一键分发前先预览和校验，降低发布失败率。
6. 过程可追踪 发布状态、错误原因、任务结果都可查询和复盘。
7. 管理持续同步 保持 CLI、Skill 和新媒体分发管理规则实时更新。

适用场景

• 用户要在 SkillHub / skills 市场中安装蚁小二能力
• 用户要首次接入 yxer
• 用户要升级 CLI 并重新同步正式 skill
• 用户只想看标准安装命令

环境要求

开始安装前，请确认环境中已安装：

• Node.js
• npm
• npx

默认优先使用 npm 安装，不引导普通用户从源码构建。

第 1 步 安装 CLI

npm install -g @yixiaoermail/cli@latest

说明：

• 这是 bootstrap skill 的标准安装方式。
• 如用户环境限制全局安装，需要明确告知风险后再改用非全局方案。

第 2 步 验证 CLI

yxer --version

预期结果：

• 命令成功返回 JSON 版本信息。
• 如果命令不存在或版本检查失败，先回到第 1 步重新安装。

第 3 步 同步正式 Skill

yxer skill sync --global

说明：

• yxer skill sync --global 是 bootstrap skill 的默认同步方式。
• 如果用户明确只想当前宿主可见、不要求全局安装，可改用 yxer skill sync。

第 4 步 初始化配置

yxer config init --api-key <apiKey>

说明：

• 让用户提供有效的 API Key 后再执行。
• 如果当前环境已完成配置，可跳过这一步。

第 5 步 环境自检

yxer doctor

说明：

• 如果 doctor 提示 _notice.skills 不一致，优先重新执行 yxer skill sync --global。
• 自检通过后，bootstrap 任务结束。

升级流程

npm install -g @yixiaoermail/cli@latest
yxer --version
yxer skill sync --global
yxer doctor

安装后进入正式能力

安装完成后，引导用户切换到正式 skill：

• 正式 skill 名称：yixiaoer
• 正式入口文档：../yixiaoer/SKILL.md
• 典型下一步命令：
  • yxer doctor
  • yxer accounts list --help
  • yxer publish --help

故障排查

如果安装失败，按以下顺序排查：

1. 确认 Node.js、npm、npx 可用
2. 重新执行 npm install -g @yixiaoermail/cli@latest
3. 执行 yxer --version
4. 执行 yxer skill sync --global
5. 执行 yxer doctor

如果需要详细业务文档或正式发布能力，不要在本 skill 内继续，切换到 yixiaoer 正式 skill。