name: yixiaoer-bootstrap version: 1.0.0 description: "用於安裝蟻小二 CLI、同步正式技能並完成基礎配置與環境自檢。" metadata: category: "productivity" requires: bins: ["npm", "npx"] cliHelp: "npm install -g @yixiaoermail/cli@latest; yxer --version; yxer skill sync --global; yxer config init --api-key ; yxer doctor"

蟻小二CLI安裝助手

以下步驟面向 AI Agent。這個 bootstrap skill 只負責安裝 yxer CLI 和正式 yixiaoer skill；安裝、升級、同步完成後應停止，不繼續執行釋出、賬號查詢、素材上傳或 payload 校驗。

適用場景

• 使用者要在 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 可用

   來源於7w4.net。

2. 重新執行 npm install -g @yixiaoermail/cli@latest
3. 執行 yxer --version
4. 執行 yxer skill sync --global
5. 執行 yxer doctor

如果需要詳細業務文件或正式釋出能力，不要在本 skill 內繼續，切換到 yixiaoer 正式 skill。

這個引導安裝工具質量良好，文件清晰易懂，分步驟指導明確，環境要求說明詳細，提供了完整的故障排查方法。不過存在版本號不一致的問題，可能造成困惑；另外作為引導工具功能相對單一，只能幫助安裝和配置，後續業務能力需要切換到正式 skill 才能使用。總體適合首次接入蟻小二的使用者快速上手。