自媒体爆款视频、文章等素材与竞品数据分析工具-易撰

概述

使用本 Skill 前，请先打开易撰官网，注册账号。注册后进入 CLI，在 APIKey 页面获取你的专属密钥。

以下步骤面向 AI Agent。这个 bootstrap Skill 只负责安装易撰 CLI 和正式 yizhuan-cli Skill；安装、升级、同步和自检完成后应停止，不继续执行作品、作者、热点、雷达、会员、收藏或关注操作。

核心原则

• 职责单一：只处理 CLI 安装或升级、正式 Skill 同步、配置初始化和环境诊断。
• 安全配置：API Key 只通过本机不回显输入或标准输入写入，不进入对话、参数或日志。
• 失败即停：任一步失败都保留脱敏错误并停止，不跳过检查或报告伪成功。
• 完成即停：doctor 通过后只报告安装结果，不在本 Skill 中执行任何业务查询或写操作。

适用场景

• 用户要在 SkillHub 或 Skills 市场中安装易撰能力。
• 用户要首次接入 yizhuan CLI。
• 用户要升级到 npm 发布的最新 CLI，并重新同步正式 Skill。
• 用户要初始化易撰 API Key 配置或诊断本地环境。
• 用户只想查看标准、安全的安装命令。

下载包安装说明

将下载包中的 skills/yizhuan-cli-installer-pro 整个目录复制到 Agent 的全局 Skills 目录。Codex 用户可复制到 ~/.codex/skills/yizhuan-cli-installer-pro，然后新建任务以加载本 Skill。完整步骤见下载包根目录的 README.md。

不要只复制下载包根目录的 SKILL.md。

环境要求

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

• Node.js 22+（22 或更高版本）
• npm
• 支持 Skills 的 AI Agent

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

安全要求

• 安装、配置、doctor、help 和 version 不作为业务活跃；不设置全局调用来源。安装完成后，正式 Skill 在每次业务调用时按当前触发原因设置 YIZHUAN_TRIGGER，并尊重现有 YIZHUAN_TELEMETRY=0。
• 执行 npm 全局安装前，说明将安装@yizhuan-cli/cli@latest（最新稳定版 CLI），并取得用户明确同意。
• 始终使用 npm 的 latest 标签获取最新稳定版，不在公开 SkillHub 内容中固定 CLI 版本。
• 不要求用户在对话中粘贴 API Key，不在命令参数、日志、Skill 文件或临时文件中展示完整 Key。
• API Key 默认由用户在真实本机终端的不回显提示中输入；自动化只能通过标准输入使用 --api-key-stdin。
• 任一步失败立即停止，保留脱敏错误，不报告伪成功。

第 1 步 安装 CLI

取得用户明确同意后执行：

npm install -g @yizhuan-cli/cli@latest

第 2 步 验证 CLI

yizhuan --version

确认命令可用且输出合法版本号。如果命令不存在或版本输出无效，先回到第 1 步重新安装，不继续同步或配置。

第 3 步 同步正式 Skill

yizhuan skill sync --global

这是安装助手的默认同步方式。检测到多个宿主时，明确使用 --host codex|agents|claude|cursor，不猜测、不覆盖未知同名目录。用户明确只要求当前项目可见时，可改用 yizhuan skill sync。

第 4 步 初始化配置

请用户在真实本机终端执行：

yizhuan config init

API Key 通过不回显提示输入。默认 API 地址为 https://yizhuan-api.yizhuan5.com；没有 Key 时访问 https://www.yizhuan5.com/app/cli-tools 创建。已有配置需要更新时使用 yizhuan config init --force。

第 5 步 环境自检

yizhuan doctor --global

只有 CLI 版本、配置、API 鉴权和正式 Skill 状态满足 doctor 要求，才报告安装完成。通过后报告版本、Skill 路径和诊断摘要并停止。如果 doctor 提示正式 Skill 不一致，优先重新执行 yizhuan skill sync --global。

如果通过 @latest 安装的 CLI 与其内置正式 Skill 版本不一致，说明发布包元数据有误。立即停止并报告版本冲突；不得为了让 doctor 通过而安装或降级到旧版 CLI。

升级流程

升级同样使用 npm 最新稳定版：

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

安装后进入正式能力

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

• 正式 Skill 名称：yizhuan-cli
• 正式入口文档：../yizhuan-cli/SKILL.md
• 典型下一步命令：yizhuan doctor、yizhuan --help；具体业务命令由正式 Skill 选择和执行。

正式 Skill 支持作品检索、作者与账号分析、微信公众号作品库与公开作者查询、平台热点、竞品雷达、我的关注、灵感收藏和会员信息等易撰真实数据查询。微信公众号暂不支持全网搜索作品，相关请求必须明确提示不支持。微信公众号请求仍由正式 yizhuan-cli 统一处理，使用 platform=wechat。

故障排查

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

1. 确认 Node.js 22 或更高版本及 npm 可用。
2. 重新执行 npm install -g @yizhuan-cli/cli@latest。
3. 执行 yizhuan --version，确认输出为合法版本号。
4. 执行 yizhuan skill sync --global。
5. 执行 yizhuan doctor --global，按脱敏诊断结果修复。

如果用户需要查询易撰数据或了解详细业务规则，不要在本 Skill 内继续，切换到正式 yizhuan-cli Skill。

完成边界

报告 CLI 版本、Skill 路径和 doctor 摘要，不展示 API Key。然后明确切换到正式 yizhuan-cli Skill；本安装助手到此停止。