yingmi-skill-cli

一个面向 Agent 的 CLI，用来完成初始化配置、原子能力调用、远端 skill 执行和版本升级。

本文只保留外部用户最常用的安装与命令说明；命令帮助会随 CLI 定义自动同步。

安装

npm install -g yingmi-skill-cli

安装完成后，可直接使用 yingmi-skill-cli。

快速开始

1. 首次使用时，先执行 yingmi-skill-cli init setup --phone <手机号>。
2. 收到验证码后，执行 yingmi-skill-cli init setup --verify-code <验证码> 完成初始化。
3. 如果要直接调用单个能力，按 mcp list -> mcp schema -> mcp call 的顺序使用。
4. 如果要完成基金分析、组合诊断、财富规划等完整场景任务，按 remote-skill list -> remote-skill enter -> remote-skill exec 的顺序使用。
5. 不确定应该用哪个命令时，先执行 yingmi-skill-cli help。

公开命令

• init：初始化 CLI、查看状态并排查环境问题
• mcp：浏览原子能力、查看 Schema 并发起单次调用
• remote-skill：发现远端场景 skill、进入上下文并执行约定脚本
• help：查看根命令、模块命令或指定子命令的帮助信息
• upgrade：检查版本并升级 CLI

命令帮助速查

yingmi-skill-cli --help

Usage: yingmi-skill-cli [options] [command]

Options:
  -V, --version          output the version number
  -h, --help             display help for command

Commands:
  init                   初始化 CLI 并查看当前状态
  mcp                    浏览原子能力摘要、查看 Schema 并直接调用工具
  remote-skill           查看金融场景 skill、进入上下文，并在该目录执行约定脚本
  help [commandPath...]  显示 CLI 或指定子命令的帮助信息
  upgrade [options]      检查 CLI 更新，并在有新版本时执行升级

常见任务:
  首次配置 CLI                yingmi-skill-cli help init
  直接调用原子金融能力         yingmi-skill-cli help mcp
  完成基金或财富场景任务       yingmi-skill-cli help remote-skill
  查看某个命令的详细帮助       yingmi-skill-cli help <command...>
  检查或升级版本              yingmi-skill-cli help upgrade

快速开始:
  1. yingmi-skill-cli init setup --phone <手机号>
  2. yingmi-skill-cli init setup --verify-code <验证码>
  3. 如果要直接调用单个能力，执行 yingmi-skill-cli mcp list
  4. 如果要完成金融场景任务，执行 yingmi-skill-cli remote-skill list
  5. 对于 mcp，继续执行 yingmi-skill-cli mcp schema <toolName>
  6. 对于 mcp，执行 yingmi-skill-cli mcp call <toolName> --input '<json>'

协议提示:
  - 结构化结果输出到 stdout
  - 提示、告警和错误输出到 stderr
  - 优先使用非交互参数，便于脚本和 Agent 调用
  - mcp 用于原子能力调用，remote-skill 用于金融场景编排
  - 调用 mcp 前建议先查看 schema 确认输入字段

yingmi-skill-cli help init

Usage: yingmi-skill-cli init [options] [command]

初始化 CLI 并查看当前状态

Options:
  -h, --help       display help for command

Commands:
  setup [options]  执行首次初始化，推荐通过手机号验证码完成配置
  status           查看初始化状态和配置摘要
  doctor           检查本地配置与运行环境
  help [command]   display help for command

用途:
  让 CLI 进入可用状态，并检查当前本地配置和运行环境。

推荐顺序:
  1. yingmi-skill-cli init setup --phone <手机号>
  2. yingmi-skill-cli init setup --verify-code <验证码>
  3. yingmi-skill-cli init status
  4. 遇到问题时执行 yingmi-skill-cli init doctor

说明:
  - setup 推荐通过手机号验证码完成初始化
  - status 用于查看当前状态摘要
  - doctor 用于排查配置或环境问题
  - 初始化完成后，调用单个能力优先使用 mcp，完成金融场景任务优先使用 remote-skill

yingmi-skill-cli help mcp

Usage: yingmi-skill-cli mcp [options] [command]

浏览原子能力摘要、查看 Schema 并直接调用工具

Options:
  -h, --help                 display help for command

Commands:
  list                       列出所有 MCP 工具摘要
  schema <toolName>          查看某个 MCP 工具的完整 Schema
  call [options] <toolName>  调用指定 MCP 工具
  help [command]             display help for command

用途:
  浏览 MCP 工具摘要，查看工具 schema，并发起单次原子能力调用。

推荐顺序:
  1. yingmi-skill-cli mcp list
  2. yingmi-skill-cli mcp schema <toolName>
  3. yingmi-skill-cli mcp call <toolName> --input '<json>'

说明:
  - mcp 适合已知要调用哪个能力、并且能明确构造 JSON 输入的场景
  - schema 用于确认字段名、参数位置和 requestBody
  - call 的输入是 JSON 协议，不是自然语言 prompt
  - 如果目标是完成基金分析、组合诊断或财富规划等场景任务，优先查看 remote-skill

最小成功示例:
  yingmi-skill-cli mcp schema GetCurrentTime
  yingmi-skill-cli mcp call GetCurrentTime

yingmi-skill-cli help mcp call

Usage: yingmi-skill-cli mcp call [options] <toolName>

调用指定 MCP 工具

Arguments:
  toolName             工具名

Options:
  --input <json>       直接传入 JSON 字符串
  --input-file <path>  从文件读取 JSON 输入
  -h, --help           display help for command

输入规则:
  1. 先执行 yingmi-skill-cli mcp schema <toolName> 确认字段名和 requestBody
  2. path/query/header 参数可直接放在 JSON 顶层，也可分别放进 path/query/header
  3. body 可显式放在 body 字段；如果工具只有 requestBody 且没有其它参数，也可直接传 body 对象
  4. mcp call 适合单次原子能力调用，不适合直接承载完整金融场景工作流

示例:
  yingmi-skill-cli mcp call GetCurrentTime
  yingmi-skill-cli mcp call GuessFundCode --input '{"fundNameOrCode":"易方达蓝筹精选"}'
  yingmi-skill-cli mcp call <toolName> --input '{"query":{"pageNum":1},"body":{"keyword":"新能源"}}'

yingmi-skill-cli help remote-skill

Usage: yingmi-skill-cli remote-skill [options] [command]

查看金融场景 skill、进入上下文，并在该目录执行约定脚本

Options:
  -h, --help         display help for command

Commands:
  scope              设置或清除当前 remote-skill 的本地可见范围
  list               展示当前可用的金融场景 skill 摘要
  enter <skillName>  进入某个场景 skill 上下文，保存当前会话，并展示目录树
  exec [options]     在最近一次进入的 skill 上下文中执行约定脚本
  help [command]     display help for command

用途:
  发现远端金融场景 skill，进入某个 skill 的工作上下文，并按 skill 约定执行脚本。

推荐顺序:
  1. 如只想围绕固定 skill 工作，先执行 yingmi-skill-cli remote-skill scope set --skills <a,b,c>
  2. yingmi-skill-cli remote-skill list
  3. yingmi-skill-cli remote-skill enter <skillName>
  4. yingmi-skill-cli remote-skill exec --script 'cat SKILL.md'
  5. 按 skill 说明执行实际脚本，例如:
     yingmi-skill-cli remote-skill exec --script 'python main.py'

注意:
  - remote-skill 用于完成基金分析、组合诊断、财富规划、市场简报等场景任务
  - 一个 skill 内部可以按需调用一个或多个 mcp
  - remote-skill exec 执行的是 shell 脚本，不是自然语言任务
  - 建议优先阅读 skill 内的 SKILL.md，再执行约定入口

yingmi-skill-cli help remote-skill exec

Usage: yingmi-skill-cli remote-skill exec [options]

在最近一次进入的 skill 上下文中执行约定脚本

Options:
  --script <content>    在当前 skill 上下文中执行 shell 脚本内容
  --script-file <path>  从文件读取脚本内容后执行
  -h, --help            display help for command

注意:
  1. 这里执行的是 shell 脚本，不是自然语言 prompt
  2. 建议优先阅读 skill 内的 SKILL.md，按 skill 约定执行脚本
  3. skill 在执行过程中可能会继续调用一个或多个 mcp
  4. 对于 Python skill，优先使用 python 命令执行入口脚本

示例:
  yingmi-skill-cli remote-skill exec --script 'cat SKILL.md'
  yingmi-skill-cli remote-skill exec --script 'python main.py'
  yingmi-skill-cli remote-skill exec --script-file ./scripts/run.sh

yingmi-skill-cli help upgrade

Usage: yingmi-skill-cli upgrade [options]

检查 CLI 更新，并在有新版本时执行升级

Options:
  --check-only  仅检查最新版本，不执行安装
  -h, --help    display help for command

用途:
  检查 CLI 是否有新版本，并在需要时执行升级。

示例:
  yingmi-skill-cli upgrade --check-only
  yingmi-skill-cli upgrade

说明:
  - --check-only 只检查版本，不执行安装；发现新版本时会输出可复制的 npm 安装命令
  - 真正升级前应明确了解副作用
  - 非交互环境下不应依赖确认输入