skz
胜可知量化平台的命令行工具。装好它，然后直接跟你的 AI 编程助手（Claude Code / Codex / openclaw / hermes）说人话——挖因子、跑策略探索、看实盘，它替你敲命令。
三步开工
# 1. 装（推荐用平台自带的包管理器）
# macOS / Linux（Homebrew）
brew install sheng-ke-zhi/tap/skz
# Windows（Scoop）
scoop bucket add skz https://github.com/sheng-ke-zhi/scoop-bucket
scoop install skz
# 任意平台（npm，需 Node.js ≥ 18）
npm install -g @shengkezhi-com/skz-quant-cli
# 2. 装 SKZ plugin（内含完整投研 skills）
skz plugin install claude # 也可明确指定 codex / openclaw / hermes / all
# 3.（可选）配一个默认身份 —— 不配也行，agent 用到时会引导你补
echo "sk_你的key" | skz auth add personal --allow-write
skz auth use personal每个 harness 只安装一个名为 skz 的原生 plugin。plugin 只提供用户级安装，内部包含
skz-guide、skz-create-problem、skz-factor、skz-candidate、skz-strategy 和 skz-portfolio。
安装成功后会清理带 SKZ 归属标记的旧 skills；外来或无法安全确认的目录不会被覆盖。
通过 Homebrew 或 Scoop 安装后，都用统一自更新：
skz update它只按当前 skz 的实际安装路径选择渠道，并分别执行 brew upgrade skz、
scoop update skz。npm 安装的不走这条——skz update 认不出 npm 的安装路径，
会跳过升级并给出重装指引，直接 npm install -g @shengkezhi-com/skz-quant-cli@latest 即可。
然后别自己敲命令，跟 agent 说
| 技能 | 干什么 | 你可以说 |
|---|---|---|
skz-guide |
从一句想法带你走到能上实盘：聊想法 → 定研究方向 → 挖因子 → 定研究问题 → 策略探索 | 「帮我研究一个动量策略」 |
skz-create-problem |
定义并创建研究问题：品种集合、市场类型、频率、训练/验证时间分段的设定规则与自检 | 「帮我创建一个股指期货日线择时的研究问题」 |
skz-factor |
因子资产：因子库、某次挖矿的产出、单因子多问题评估、软删不成立的 | 「看看我的因子库」 |
skz-candidate |
探索候选：评审实验结果、删除候选、把选中的候选保存入库 | 「看看这次探索有没有值得保存的」 |
skz-strategy |
已入库策略：净值/持仓/回撤/交易明细、巡检、切换实盘·暂停·废弃、备注和赠予 | 「我实盘最近怎么样」 |
skz-portfolio |
组合资产：把实盘策略按权重打包、查净值/回撤/持仓、再平衡 | 「把这几个策略打包成一个组合」 |
花钱的和不可逆的，agent 会先问你——挖矿、策略探索、保存入库、切实盘、删因子、删候选、建组合，都得你点头才跑。
多账户与只读身份
每把 key 存成一个命名身份，随后选择机器级默认身份。切换身份不会自动发请求：
echo "sk_alice的key" | skz auth add alice --read-only
echo "sk_bob的key" | skz auth add bob --allow-write
echo "sk_charlie的key" | skz auth add charlie --allow-write
skz auth list
skz auth use alice
skz auth status--read-only 是 CLI 本地策略：alice 的读命令照常执行，任何写和触发都在发请求前被拒绝。--allow-write 只表示 CLI 允许写，实际权限仍由 key 的后端 scope 决定。agent 不得因为 bob、charlie 都可写就自行选择；每条工作流开始前先用 auth status 确认默认身份。
如果同一账户需要多把不同权限的 key，用不同 identity 名并显式声明共同账户：
echo "sk_alice只读key" | skz auth add alice-read --account alice --read-only
echo "sk_alice写key" | skz auth add alice-write --account alice --allow-write全局只读模式
想让所有身份都只读——比如要放 agent 长时间自己跑——设一个环境变量：
export SKZ_READ_ONLY=1
skz auth status # {"present":true,"readOnly":true} ← 一定要亲眼确认这一行设了之后，即使当前身份是 --allow-write，所有写和触发（挖矿、探索、保存入库、建组合、改状态、删除、笔记标签）仍一律拒绝并退出码 8，请求根本不会发出去；读和进度轮询照常。
几件要知道的事：
skz auth status那一步别省。 变量名打错会静默变成「没设」，而你以为设上了。这是这类开关唯一的失效方式，也是唯一的检查手段。- 关掉只能
unset SKZ_READ_ONLY。 设成0或false会直接报错，不会当成关闭——否则一行SKZ_READ_ONLY=0 skz ...就绕过去了。 - 你自己也一样写不了。 真要做一次写操作，在另一个没设这个变量的终端里跑。
- 这是防手滑，不是安全边界。 key 就在本机文件里，铁了心绕总有办法。它挡的是 agent 顺手闯祸，不是对抗性行为。要真正不可绕过，得让 key 的主人发一把不带写权限的 key。