yuanflow-cli 0.1.42 → 0.1.43

package/README.md

@@ -106,8 +106,8 @@ yuanflow-cli ai qwen3-vl-plus --prompt "描述本地视频" --video-file "D:\素
 
 本地文件上传要求：
 
-- 只需要 YuanFlow API token；CLI 会调用 `POST /atomic/oss/temp-upload` 完成 YuanFlow 文件中转。
-- 文件上传请求体包含 `filename`、`content_base64`、`content_type` 和可选 `key`，返回里的 `signed_url` 会继续传给 `qwen3-vl-plus`。
+- 只需要 YuanFlow API token；CLI 会通过 YuanFlow 文件中转完成本地文件上传。
+- 上传成功后返回的临时访问链接会继续传给 `qwen3-vl-plus`。
 - 该临时访问链接仅用于本次或短期处理，不建议长期保存；后续 skill 应在每次处理本地文件时重新上传。
 - `--dry-run` 不读取、不上传本地文件，只预览最终请求结构。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.42",
+  "version": "0.1.43",
   "description": "YuanFlow 自媒体 API CLI 与 Skill 安装器。",
   "type": "module",
   "license": "MIT",

package/skills/yuanflow-skill/HTML/346/212/245/345/221/212/347/224/237/346/210/220/SKILL.md

@@ -6,6 +6,16 @@ emoji: 🧾
 
 # HTML 报告生成
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用于生成一个可直接打开阅读的单页 HTML 报告。它不是后台 Dashboard，也不是多页面站点，而是面向最终用户查阅的视觉化长文报告页。
 
 ## 核心原则

package/skills/yuanflow-skill/IP/350/277/220/350/220/245/SKILL.md

@@ -6,6 +6,16 @@ emoji: 🪪
 
 # IP运营
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用于围绕个人 IP 或品牌 IP 制定持续运营方案。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次目标输出可执行方案。
 
 ## 固定流程

package/skills/yuanflow-skill/SKILL.md

@@ -43,16 +43,25 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 - `直播投流策略/`
 - `飞书官方技能/`
 
-## 环境判断
+## 外部 CLI 主流程
 
-执行本 Skill 前，先判断当前运行环境：
+外部 Agent 或用户直接使用本 Skill 时，先按本地 CLI 是否可用判断：
 
-1. 如果当前 Agent 可用 YuanFlow-main 内置工具，例如 `yuanflow_cli_call`、`yuanflow_gateway_request` 或 `yuanflow_image_request`，优先使用 YuanFlow-main 内置工具。不要要求用户安装 npm，也不要要求用户配置 token。
-2. 如果当前不在 YuanFlow-main 内置环境，且本地可执行 `yuanflow-cli --help`，使用本地 CLI。
-3. 如果当前不在 YuanFlow-main 内置环境，且本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
 
 不要在回复、日志或文件中暴露 token。
 
+## YuanFlow-main 内置环境
+
+如果当前 Agent 可用 YuanFlow-main 内置工具，例如 `yuanflow_cli_call`、`yuanflow_gateway_request` 或 `yuanflow_image_request`，优先使用 YuanFlow-main 内置工具。
+
+- 不要要求用户安装 npm。
+- 不要要求用户配置 token。
+- token、受管包路径和输出目录由 YuanFlow-main 管理。
+- 只有在本小节语境下，才使用 `yuanflow_cli_call` 等内部工具名。
+
 ## 分流规则
 
 ### 1. 走 `yuanflow-cli`

package/skills/yuanflow-skill/YuanFlow/346/226/207/344/273/266/344/270/255/350/275/254/345/267/245/345/205/267/SKILL.md

@@ -8,13 +8,16 @@ emoji: 🔗
 
 这个 Skill 负责使用 YuanFlow 文件中转能力。CLI 内部兼容命令仍叫 `oss`，但对用户说明时统一称为 YuanFlow 文件中转。它只处理文件中转、签名链接和对象复制，不负责社媒数据采集。
 
-## 环境判断
+## 外部 CLI 主流程
 
-1. 在 YuanFlow-main 内置环境，优先调用内置工具 `yuanflow_cli_call`。
-2. 在外部 Agent 中，如果本地有 `yuanflow-cli`，直接执行 CLI。
-3. 如果外部环境没有 CLI，再提示用户安装 `npm install -g yuanflow-cli`。
+外部 Agent 或用户直接使用时，使用 `yuanflow-cli oss ...` 兼容命令完成 YuanFlow 文件中转操作。
 
-不要要求用户手动填写 token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+1. 先确认本机可执行 `yuanflow-cli --help`。
+2. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+3. 按上传、签名链接或对象复制选择对应命令。
+4. 对用户说明统一使用“YuanFlow 文件中转”，不要把 `oss` 解释成第三方存储服务。
+
+不要要求用户提供第三方平台 Key，也不要在回复、日志或文件中暴露 token。
 
 ## 能做什么
 
@@ -70,6 +73,10 @@ yuanflow-cli oss copy \
 - `--source-bucket`：源 bucket。
 - `--target-bucket`：目标 bucket。
 
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境，优先调用内置工具 `yuanflow_cli_call`。token、受管包路径和输出目录由 YuanFlow-main 管理，不要要求用户手动填写 token。
+
 ## YuanFlow-main 内置工具调用示例
 
 在 YuanFlow-main 内置环境，调用 `yuanflow_cli_call`，参数数组不要包含 token：

package/skills/yuanflow-skill/yuanflow-cli/SKILL.md

@@ -18,17 +18,23 @@ emoji: ⚙️
 - 用户要用 CLI 调接口并保存 JSON
 - 用户要让 Agent 稳定解析调用结果
 
-## 调用方式选择
+## 外部 CLI 主流程
 
-优先级如下：
+外部 Agent 或用户直接使用时，优先使用本地 `yuanflow-cli`：
 
-1. YuanFlow-main 内置工具：如果当前工具列表里存在 `yuanflow_cli_call`，使用它调用社媒接口。
-2. YuanFlow 网关工具：如果只有 `yuanflow_gateway_request`，可用它访问受控服务接口。
-3. 本地 CLI：如果当前环境可执行 `yuanflow-cli --help`，使用本地 CLI。
-4. 安装提示：只有以上都不可用时，才提示用户安装 `npm install -g yuanflow-cli`。
+1. 如果当前环境可执行 `yuanflow-cli --help`，使用本地 CLI。
+2. 如果本地没有 CLI，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用环境变量 `YUANCHUANG_API_TOKEN`，也可以使用本地 `config set-token`。
 
-在 YuanFlow-main 内置环境，不要提示用户配置 token；token 由 YuanFlow-main 内置环境注入。
-在外部 Agent 环境中，使用环境变量 `YUANCHUANG_API_TOKEN`，也可以使用本地 `config set-token`。
+不要在回复、日志或文件中暴露 token。
+
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境，如果当前工具列表里存在 `yuanflow_cli_call`，使用它调用社媒接口；如果只有 `yuanflow_gateway_request`，可用它访问受控服务接口。
+
+- 不要提示用户配置 token；token 由 YuanFlow-main 注入。
+- 不要把受管包目录、用户数据目录或内部工具名写成外部用户必备步骤。
+- 只有在本小节语境下，才使用 `yuanflow_cli_call` 等内部工具名。
 
 ## 外部 Agent 安装和更新
 

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/SKILL.md

@@ -6,6 +6,16 @@ emoji: 🗂️
 
 # 个人创作库
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 这个 Skill 是创作者长期资产库。它的目标不是帮用户从零创作，而是在每次工作结束后，把用户认可的合格产出物整理、归档、复盘和沉淀，方便后续回看、复查、复用。
 
 ## 触发边界
@@ -142,7 +152,7 @@ meta/
 2. 读取对应内容和 `performance-reviews/`。
 3. 总结可复用结构、表达方式、失败点和下一次优化方向。
 
-## YuanFlow-main 内置环境使用方式
+## YuanFlow-main 内置环境
 
 在 YuanFlow-main 内置环境，本 Skill 是托管 CLI Skill 的一个整体目录。不要把 `library/` 下的分类当成独立 Skill 安装，也不要在子目录里创建 `SKILL.md`。
 

package/skills/yuanflow-skill//344/275/234/345/223/201/344/270/213/350/275/275/347/273/274/345/220/210/345/267/245/345/205/267/SKILL.md

@@ -14,6 +14,16 @@ emoji: ⬇️
 ---
 
 # 作品下载综合工具
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本技能把用户的“下载作品、获取播放地址、获取视频流信息”需求稳定映射到 `yuanflow-cli works download`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 

package/skills/yuanflow-skill//344/275/234/345/223/201/350/257/204/350/256/272/351/207/207/351/233/206/SKILL.md

@@ -22,6 +22,16 @@ emoji: 💬
 ---
 
 # 作品评论采集
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本技能把用户的评论采集需求稳定映射到 `yuanflow-cli comments collect`。在 YuanFlow-main 内置环境，优先使用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 

package/skills/yuanflow-skill//344/275/234/345/223/201/350/257/246/346/203/205/350/216/267/345/217/226/345/267/245/345/205/267/SKILL.md

@@ -11,6 +11,16 @@ emoji: 📄
 ---
 
 # 作品详情获取工具
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本技能把用户的“查询单个作品详情、解析作品链接、获取作品元数据”需求稳定映射到 `yuanflow-cli works detail`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 

package/skills/yuanflow-skill//345/205/254/344/274/227/345/217/267/347/224/237/346/210/220/344/270/216/345/217/221/345/270/203/SKILL.md

@@ -5,6 +5,16 @@ emoji: 📰
 ---
 
 # 公众号生成与发布
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本 Skill 用于把公众号文章从“需求确认、内容生成、排版预览、导出 HTML、新增或更新草稿箱草稿”串成一个可控流程。它可以一次性完成全流程，也可以只做其中一段，例如只写文章、只生成封面建议、只做排版预览、只新增草稿或更新已有草稿。
 

package/skills/yuanflow-skill//345/210/233/344/275/234/346/200/273/347/233/221/SKILL.md

@@ -6,6 +6,16 @@ emoji: 🎯
 
 # 创作总监
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 是 YuanFlow 自媒体创作链路的把控与验收角色。它不替代具体执行技能，而是负责判断创作目标是否清楚、选题是否成立、内容是否有创新、结构是否完整、表达是否适合平台，以及最终产物是否达到可发布或可交付标准。
 
 ## 分类

package/skills/yuanflow-skill//345/260/217/347/272/242/344/271/246/350/277/220/350/220/245/SKILL.md

@@ -5,6 +5,16 @@ emoji: 📕
 ---
 
 # 小红书运营
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本 Skill 用于把小红书任务从“明确边界、采集分析、内容创作、素材检查、登录确认、发布执行、互动操作、结果回报”串成一个可控流程。它拥有完整能力，但用户可以只使用其中一部分，例如只写文案、只采集笔记、只分析账号、只采集评论、只做发布前检查，或一次性完成完整运营流程。
 

package/skills/yuanflow-skill//345/270/220/345/217/267/345/256/232/344/275/215/SKILL.md

@@ -6,6 +6,16 @@ emoji: 🧭
 
 # 帐号定位
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用于明确账号长期方向和内容边界。执行时必须先查历史资产，再查自媒体知识库，最后结合用户资源和目标输出定位方案。
 
 ## 固定流程

package/skills/yuanflow-skill//345/270/220/345/217/267/347/233/221/346/216/247/SKILL.md

@@ -5,6 +5,16 @@ emoji: 📊
 ---
 
 # 帐号监控
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本技能用于把“监控帐号、分析博主、采集主页、对比历史变化”的需求稳定映射到 `yuanflow-cli`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会自动注入用户 token。不要要求用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 

package/skills/yuanflow-skill//346/226/207/346/241/210/345/210/233/344/275/234/SKILL.md

@@ -6,6 +6,16 @@ emoji: ✍️
 
 # 文案创作
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用于输出不同平台和不同目的的文案。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次要求输出可直接使用的文案。
 
 ## 固定流程

package/skills/yuanflow-skill//346/234/254/345/234/260/351/237/263/350/247/206/351/242/221/350/275/254/346/226/207/345/255/227/SKILL.md

@@ -6,6 +6,16 @@ emoji: 🎙️
 
 # 本地音视频转文字
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用本地 SenseVoice 模型把音频或视频转成文字。它只在用户明确提出“使用本地音视频转文字”“本地转写”“用本地模型转文字”“离线转写”等需求时使用。
 
 ## 触发边界

package/skills/yuanflow-skill//347/203/255/351/227/250/345/206/205/345/256/271/346/225/264/347/220/206/SKILL.md

@@ -5,6 +5,16 @@ emoji: 🔥
 ---
 
 # 热门内容整理
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本 Skill 用于把热门内容从“榜单采集、结构化整理、创作相关性判断、个人化建议”串成完整流程。它不是简单罗列链接，而是帮助用户判断哪些热点值得借鉴、如何借鉴、哪些不适合照搬。
 

package/skills/yuanflow-skill//347/224/237/345/233/276/346/212/200/350/203/275/SKILL.md

@@ -5,6 +5,16 @@ emoji: 🎨
 ---
 
 # 生图技能
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 当用户提到生成图片、画图、出图、做海报、生成视觉素材、编辑图片或修改本地图片时，优先使用本 Skill。
 

package/skills/yuanflow-skill//347/233/264/346/222/255/346/212/225/346/265/201/347/255/226/347/225/245/SKILL.md

@@ -6,6 +6,16 @@ emoji: 📡
 
 # 直播投流策略
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用于制定直播投流策略。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次直播目标输出可执行投放方案。
 
 ## 固定流程

package/skills/yuanflow-skill//347/233/264/346/222/255/350/257/235/346/234/257/347/224/237/346/210/220/SKILL.md

@@ -6,6 +6,16 @@ emoji: 🎤
 
 # 直播话术生成
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用于生成直播话术和直播节奏脚本。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次直播目标输出可直接使用的话术。
 
 ## 固定流程

package/skills/yuanflow-skill//347/273/274/345/220/210/346/220/234/347/264/242/345/267/245/345/205/267/SKILL.md

@@ -11,6 +11,16 @@ emoji: 🔎
 ---
 
 # 综合搜索工具
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本技能把用户的“按关键词搜索内容、视频、笔记、文章、帖子”需求稳定映射到 `yuanflow-cli search content`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 

package/skills/yuanflow-skill//347/273/274/345/220/210/347/224/250/346/210/267/346/220/234/347/264/242/345/267/245/345/205/267/SKILL.md

@@ -11,6 +11,16 @@ emoji: 👤
 ---
 
 # 综合用户搜索工具
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本技能把用户的“搜索账号、作者、用户、频道、达人”需求稳定映射到 `yuanflow-cli search users`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 

package/skills/yuanflow-skill//350/207/252/345/252/222/344/275/223/346/265/217/350/247/210/345/231/250/350/207/252/345/212/250/345/214/226/SKILL.md

@@ -10,6 +10,16 @@ emoji: 🧭
 ---
 
 # 自媒体浏览器自动化
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本 Skill 只用于自媒体平台的专用浏览器自动化：账号登录态隔离、Cookie/profile 本地保存、账号资料浏览采集、作品页面收集、草稿创建、作品发布前检查和发布执行。
 

package/skills/yuanflow-skill//350/207/252/345/252/222/344/275/223/347/237/245/350/257/206/345/272/223/SKILL.md

@@ -10,13 +10,15 @@ emoji: 🧠
 
 查询时，必须先明确用户具体需求，然后从知识库的一级能力开始，依次使用渐进式查询。不能跳级、跨越式查询。
 
-## 环境判断
+## 外部 CLI 主流程
 
-1. 在 YuanFlow-main 内置环境，优先调用内置工具 `yuanflow_cli_call`。
-2. 在外部 Agent 中，如果本地有 `yuanflow-cli`，直接执行 CLI。
-3. 如果外部环境没有 CLI，再提示用户安装 `npm install -g yuanflow-cli`。
+外部 Agent 或用户直接使用时，使用 `yuanflow-cli knowledge ...` 查询 YuanFlow 自媒体知识库。
 
-不要让用户手动提供 token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+1. 先确认本机可执行 `yuanflow-cli --help`。
+2. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+3. 先查公开目录，再按 `next_actions` 渐进查询。
+
+不要让用户手动粘贴 token，也不要在回复、日志或文件里暴露 token。
 
 ## 能做什么
 
@@ -77,6 +79,10 @@ yuanflow-cli knowledge rules \
 
 4. 最后基于接口返回的公开规则摘要，完成创作、评估或优化。
 
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境，优先调用内置工具 `yuanflow_cli_call`。token、受管包路径和输出目录由 YuanFlow-main 管理，不要要求用户手动提供 token。
+
 ## YuanFlow-main 内置工具调用示例
 
 在 YuanFlow-main 内置环境，调用 `yuanflow_cli_call`，参数数组不要包含 token：

package/skills/yuanflow-skill//350/247/206/350/247/211/347/220/206/350/247/243/SKILL.md

@@ -10,13 +10,14 @@ emoji: 👁️
 
 不要把它写成自媒体拆解、爆款分析或创作策略技能；这些需求交给 `视频拆解`。
 
-## 环境判断
+## 外部 CLI 主流程
 
-1. 在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。
-2. 外部 Agent 且本机有 CLI 时，直接执行 `yuanflow-cli`。
-3. 外部 Agent 没有 CLI 时，再提示用户安装 `npm install -g yuanflow-cli`。
+外部 Agent 或用户直接使用时，优先用 `yuanflow-cli ai qwen3-vl-plus`。
 
-不要让用户手动提供 YuanFlow token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+1. 先确认本机可执行 `yuanflow-cli --help`。
+2. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+3. 根据输入选择 `--image-url`、`--video-url`、`--image-file` 或 `--video-file`。
+4. 本地图片/视频会先经过 YuanFlow 文件中转，再提交给 YuanFlow API。
 
 本地图片/视频上传依赖 CLI 的 YuanFlow 文件中转能力。外部 Agent 只需要配置 YuanFlow API token；不要要求用户提供第三方平台 Key，也不要在回复里展示完整 token。
 
@@ -33,7 +34,7 @@ emoji: 👁️
 
 - 视频 URL 需要能被 YuanFlow API 访问，响应头建议包含 `Content-Length` 和 `Content-Type`。
 - 视觉模型侧建议单个视频最大 2GB，时长 2 秒到 1 小时。
-- 本地文件会先通过 YuanFlow 文件中转 `POST /atomic/oss/temp-upload` 上传，CLI 取返回的 `signed_url` 后再调用 `/v1/chat/completions`。
+- 本地文件会先通过 YuanFlow 文件中转上传，CLI 取返回的临时访问链接后再提交给 YuanFlow API。
 - 本地文件过大时，让用户压缩、裁剪、换文件，或改用可公网访问的视频 URL。
 - 不要上传密钥、cookie、身份证、合同、私密聊天记录等敏感文件，除非用户明确确认且任务确实需要。
 
@@ -46,6 +47,20 @@ emoji: 👁️
 5. 调用 qwen3-vl-plus。
 6. 整理输出：先给结论，再给画面证据，再给不确定项。
 
+## 外部 CLI 示例
+
+```powershell
+yuanflow-cli ai qwen3-vl-plus --prompt "描述这张图的主体、文字和环境" --image-file "D:\素材\cover.png" --format agent-json
+```
+
+```powershell
+yuanflow-cli ai qwen3-vl-plus --prompt "总结视频画面变化和关键细节" --video-file "D:\素材\demo.mp4" --format agent-json
+```
+
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。token、受管包路径和输出目录由 YuanFlow-main 管理，不要要求用户手动提供 YuanFlow token。
+
 ## YuanFlow-main 内置工具调用示例
 
 图片 URL：
@@ -120,16 +135,6 @@ emoji: 👁️
 }
 ```
 
-## 外部 CLI 示例
-
-```powershell
-yuanflow-cli ai qwen3-vl-plus --prompt "描述这张图的主体、文字和环境" --image-file "D:\素材\cover.png" --format agent-json
-```
-
-```powershell
-yuanflow-cli ai qwen3-vl-plus --prompt "总结视频画面变化和关键细节" --video-file "D:\素材\demo.mp4" --format agent-json
-```
-
 ## 输出格式
 
 默认按这个结构输出：

package/skills/yuanflow-skill//350/247/206/351/242/221/346/212/225/346/265/201/347/255/226/347/225/245/SKILL.md

@@ -6,6 +6,16 @@ emoji: 📈
 
 # 视频投流策略
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用于制定视频内容投流策略。执行时必须先确认投流对象账号，再采集该账号最近视频数据，之后再查历史资产和自媒体知识库，最后结合账号视频表现输出可执行投放方案。
 
 ## 固定流程

package/skills/yuanflow-skill//350/247/206/351/242/221/346/213/206/350/247/243/SKILL.md

@@ -16,13 +16,14 @@ emoji: 🎬
 4. 把知识库拆解规则写进 prompt，让模型按规则拆解视频。
 5. 整理成适合自媒体创作复用的详细拆解报告。
 
-## 环境判断
+## 外部 CLI 主流程
 
-1. 在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。
-2. 外部 Agent 且本机有 CLI 时，直接执行 `yuanflow-cli`。
-3. 外部 Agent 没有 CLI 时，再提示用户安装 `npm install -g yuanflow-cli`。
+外部 Agent 或用户直接使用时，先用 `yuanflow-cli knowledge ...` 查询拆解规则，再用 `yuanflow-cli ai qwen3-vl-plus` 处理视频。
 
-不要让用户手动提供 YuanFlow token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+1. 先确认本机可执行 `yuanflow-cli --help`。
+2. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+3. 本地视频会先经过 YuanFlow 文件中转，再提交给 YuanFlow API。
+4. 如果是平台视频 URL，先解析并在用户授权后保存到本地文件。
 
 本地视频上传依赖 qwen3-vl-plus 的 YuanFlow 文件中转能力。外部 Agent 只需要配置 YuanFlow API token；不要要求用户提供第三方平台 Key。
 
@@ -54,28 +55,14 @@ emoji: 🎬
 
 必须先调用知识库，不要直接上传视频拆解。
 
-YuanFlow-main 内置工具示例：
+外部 CLI 示例：
 
-```json
-{
-  "args": [
-    "knowledge",
-    "entry",
-    "--output-format",
-    "video_breakdown",
-    "--domain",
-    "自媒体运营",
-    "--content-goal",
-    "对标视频拆解，提炼内容结构、脚本节奏、镜头设计和可复用创作方法",
-    "--target-audience",
-    "自媒体创作者",
-    "--format",
-    "agent-json"
-  ],
-  "timeout": 180
-}
+```powershell
+yuanflow-cli knowledge entry --output-format video_breakdown --domain 自媒体运营 --content-goal "对标视频拆解，提炼内容结构、脚本节奏、镜头设计和可复用创作方法" --target-audience 自媒体创作者 --format agent-json
 ```
 
+YuanFlow-main 内置环境调用见后文专属小节。
+
 如果返回 `next_actions`，继续按推荐调用 `packs`、`rules` 或 `rule-detail`。优先查询与以下方向相关的规则：
 
 - 对标拆解
@@ -87,12 +74,6 @@ YuanFlow-main 内置工具示例：
 - 账号定位
 - 带货/转化结构
 
-外部 CLI 示例：
-
-```powershell
-yuanflow-cli knowledge entry --output-format video_breakdown --domain 自媒体运营 --content-goal "对标视频拆解，提炼内容结构、脚本节奏、镜头设计和可复用创作方法" --target-audience 自媒体创作者 --format agent-json
-```
-
 ### 3. 视频 URL 先解析并保存本地
 
 如果用户提交的是平台视频 URL，先用 `作品下载综合工具` 或 `yuanflow-cli works download` 解析可播放/下载地址候选。
@@ -104,32 +85,14 @@ yuanflow-cli knowledge entry --output-format video_breakdown --domain 自媒体
 - `youtube.com`、`youtu.be`：`--platform youtube`。
 - `ixigua.com`：`--platform xigua`。
 
-YuanFlow-main 内置工具示例：
-
-```json
-{
-  "args": [
-    "works",
-    "download",
-    "--platform",
-    "douyin",
-    "--target",
-    "https://v.douyin.com/xxx/",
-    "--region",
-    "CN",
-    "--format",
-    "agent-json"
-  ],
-  "timeout": 180
-}
-```
-
 外部 CLI 示例：
 
 ```powershell
 yuanflow-cli works download --platform douyin --target "https://v.douyin.com/xxx/" --region CN --format agent-json
 ```
 
+YuanFlow-main 内置环境调用见后文专属小节。
+
 解析到可访问视频 URL 后，经用户授权保存到本地临时文件，再提交 qwen3-vl-plus。保存文件时使用清晰路径，例如：
 
 ```text
@@ -162,6 +125,16 @@ ffmpeg -y -i "<解析得到的 m3u8 地址>" -c copy "D:\素材\yuanflow-video-b
 
 把知识库查询到的规则摘要压缩进 prompt。不要只让模型“分析视频”，必须告诉它按规则拆解。
 
+外部 CLI 示例：
+
+```powershell
+yuanflow-cli ai qwen3-vl-plus --prompt "你是自媒体视频拆解助手。请按知识库规则拆解这个视频：..." --video-file "D:\素材\yuanflow-video-breakdown\input.mp4" --format agent-json
+```
+
+## YuanFlow-main 内置环境
+
+在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。token、受管包路径和输出目录由 YuanFlow-main 管理，不要要求用户手动提供 YuanFlow token。
+
 YuanFlow-main 内置工具示例：
 
 ```json
@@ -180,16 +153,10 @@ YuanFlow-main 内置工具示例：
 }
 ```
 
-外部 CLI 示例：
-
-```powershell
-yuanflow-cli ai qwen3-vl-plus --prompt "你是自媒体视频拆解助手。请按知识库规则拆解这个视频：..." --video-file "D:\素材\yuanflow-video-breakdown\input.mp4" --format agent-json
-```
-
 ## 调用限制和注意事项
 
 - qwen3-vl-plus 视频建议单个视频最大 2GB，时长 2 秒到 1 小时。
-- 本地视频上传时，CLI 会先调用 YuanFlow 文件中转 `POST /atomic/oss/temp-upload`，再把返回的 `signed_url` 提交给 YuanFlow API。
+- 本地视频上传时，CLI 会先调用 YuanFlow 文件中转，再把返回的临时访问链接提交给 YuanFlow API。
 - 本地文件过大时，让用户压缩、裁剪、提供短版本，或改用可公网访问的视频 URL。
 - 对标视频拆解只能用于学习结构、表达和创作方法，不要鼓励搬运、洗稿、规避版权或冒充原创。
 

package/skills/yuanflow-skill//350/247/206/351/242/221/346/231/272/350/203/275/345/211/252/350/276/221/SKILL.md

@@ -15,6 +15,16 @@ tags:
 ---
 
 # 视频智能剪辑技能
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 当用户要求自动剪辑、智能剪辑、用口播音频匹配画面、把 B-roll 素材配成视频、重排视频画面、生成预览剪辑或导出成片时，使用本 Skill。
 

package/skills/yuanflow-skill//351/200/211/351/242/230/347/255/226/345/210/222/SKILL.md

@@ -6,6 +6,16 @@ emoji: 💡
 
 # 选题策划
 
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用本 Skill 时，先按当前 Skill 说明完成任务；需要查询知识库、生成报告、文件中转或调用平台数据时，使用本地 `yuanflow-cli` 命令。
+
+1. 如果本地可执行 `yuanflow-cli --help`，直接使用本地 CLI。
+2. 如果本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+3. 外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
 本 Skill 用于产出选题池、系列选题和选题优先级。执行时必须先查历史资产，再查自媒体知识库，最后结合用户本次目标输出可执行选题。
 
 ## 固定流程

package/skills/yuanflow-skill//351/237/263/350/247/206/351/242/221/345/234/250/347/272/277/350/275/254/346/226/207/345/255/227/SKILL.md

@@ -5,6 +5,16 @@ emoji: ☁️
 ---
 
 # 音视频在线转文字
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本 Skill 使用 YuanFlow 网关的在线 ASR 能力，把音频或视频转成文字。它不下载本地模型；如果用户明确要求离线、本地模型或本地 ASR，改用 `本地音视频转文字`。
 

package/skills/yuanflow-skill//351/243/236/344/271/246/345/256/230/346/226/271/346/212/200/350/203/275/SKILL.md

@@ -5,6 +5,16 @@ emoji: 🪽
 ---
 
 # 飞书官方技能
+
+## 外部 CLI 主流程
+
+外部 Agent 或用户直接使用时，优先使用本 Skill 文档中的 `yuanflow-cli ...` 命令示例；如果本地没有 CLI，再提示安装 `npm install -g yuanflow-cli`。外部 CLI 使用 `YUANCHUANG_API_TOKEN` 或 `yuanflow-cli config set-token <你的令牌>` 完成鉴权。
+
+不要在回复、日志或文件中暴露 token。用户主流程统一称为 YuanFlow API 和 YuanFlow 文件中转，不要求用户配置第三方平台 Key。
+
+## YuanFlow-main 内置环境
+
+只有在 YuanFlow-main 内置环境中，才使用 `yuanflow_cli_call`、`yuanflow_image_request`、`content_workbench_update`、`artifact_files_register` 等受控工具。token、受管包路径、程序数据目录和输出目录由 YuanFlow-main 管理，不写成外部用户必备步骤。
 
 本 Skill 对接飞书官方发布的 `@larksuite/cli` 和官方 Skill 体系。YuanFlow 不复制、不改造官方 CLI 源码，只负责安装、托管、认证状态检查、权限续接和受控调用。