跳到主要内容

Skills

turing-cli skills 把图灵发布的 Agent Skills 安装到你本机使用的 Agent 中,并负责之后的更新和卸载。需要 turing-cli 0.4.0 或更高版本。

可安装的 Skills​

Skill用途
turing-memory在多个 Agent 之间 Recall / Remember 同一份个人长期记忆,见 Memory
turing-operations查询图灵平台的用量、费用和 token,见 Operations
turing-artifacts在图灵平台创建、修改、渲染和分享 Artifact
everything-2-markdown把 PDF / Word / Excel / PowerPoint 转成 Markdown,见 Documents

运行 turing-cli skills list 查看当前发布渠道中的全部 Skills。

安装​

在终端里运行:

turing-cli skills install

CLI 依次请你选择 Skill、安装范围和 Agent,列出将要写入的目录后再确认:

  • 安装范围默认是当前用户,对所有项目生效;也可以选当前项目,以执行命令时的工作目录为项目目录。
  • Agent 列表预选检测到的 Agent,也可以手动选择任何已支持的 Agent。只列出在所选范围内有目录的 Agent。

也可以用参数直接指定:

turing-cli skills install --skill turing-operations --agent claude-code --agent opencode --global --yes
turing-cli skills install --skill '*' --agent codex --project --yes
参数说明
--skillSkill 名称,可重复;'*' 表示全部,且只能单独使用
--agentAgent 名称,可重复,取值见支持的 Agent
-g, --global安装到当前用户范围
-p, --project安装到当前项目
-y, --yes不再提问,见下方说明
--catalog-url指定 Skill 清单地址,默认与 CLI 的发布渠道一致
在 Agent 或脚本中运行

--yes 等同于在每个提示处直接回车:使用当前用户范围和检测到的 Agent,并跳过确认;一个 Agent 都没检测到时报错。加了 --yes 的命令在任何环境中都不会停下来等输入,所以由 Agent 代为运行时,应当总是带上 --yes。Skill 没有默认选项,--skill 仍需显式给出。

不带 --yes 的非交互运行(例如在 CI 中)必须同时给出 --skill、--agent,以及 --global 或 --project。

支持的 Agent​

Agent--agent当前用户目录项目目录
Claude Codeclaude-code~/.claude/skills,跟随 CLAUDE_CONFIG_DIR.claude/skills
OpenCodeopencode~/.config/opencode/skills,跟随 XDG_CONFIG_HOME.agents/skills
Codexcodex~/.agents/skills.agents/skills
CodeBuddycodebuddy~/.codebuddy/skills.codebuddy/skills
OpenClawopenclaw~/.openclaw/skills不支持
  • 多个 Agent 共用同一个目录时(例如项目中的 .agents/skills),只写入一次。
  • Agent 的配置目录中除了 skills/ 还有其他内容,才算检测到该 Agent。
  • 在用户主目录下使用 --project 会被拒绝,因为它和当前用户范围是同一组目录。
  • Codex 从 ~/.agents/skills 读取用户 Skills;$CODEX_HOME/skills 是 Codex 已弃用、仅为兼容保留的位置,所以 CODEX_HOME 只用于检测 Codex 是否已安装。
  • OpenClaw 从它自己配置的 workspace 读取项目 Skills,不读当前目录,因此不支持 --project。它会优先读取 ~/.agents/skills,同名时以那里为准,所以为 OpenClaw 安装时,那里已有的旧版副本或未改动的受管副本会一并更新(没有就不创建,改过的副本不动);status、update 对 OpenClaw 也会包含这个目录。

查看与更新​

turing-cli skills status
turing-cli skills update
  • status 默认列出当前用户和当前项目中由 turing-cli 管理的 Skills;加 --global 或 --project 只看一个范围,加 --agent 只看指定 Agent。
  • update 默认更新当前用户范围,update --project 更新当前项目。只有 SHA-256 与清单不一致时才会下载;某个 Skill 更新失败不会阻断其他 Skill,失败项在最后统一报告。
  • 每个 Skill 沿用安装时的发布渠道。需要切换渠道时,显式指定 --catalog-url。

卸载​

turing-cli skills remove --skill turing-operations --agent opencode --global --yes

remove 只删除由 turing-cli 安装、且没有本地修改的副本。

  • remove --yes 不指定 --agent 时,和 status、update 一样覆盖所有 Agent。此时遇到其他工具留下的同名目录(没有安装记录,例如 npx skills 放在 ~/.agents/skills 的副本),会跳过并提示。
  • 在用 --agent 指定或在选择器里选定的 Agent 下遇到这类目录时,整个卸载请求失败,什么都不删除。安装记录损坏的副本,以及指向受管副本的符号链接,也会让请求失败。
  • ~/.agents/skills 是 Codex 的目录,remove --agent openclaw 不会删除那里的副本,而是提示加上 --agent codex 才能一并移除。

安装记录与本地修改​

每个安装目录中都有一份安装记录 .turing-cli-skill.json,记录来源清单、版本和每个文件的 SHA-256。turing-cli 只更新或卸载它自己安装并记录的目录:

  • 遇到已有的同名 Skill(不是 turing-cli 安装的)时拒绝覆盖。
  • 修改过的副本不会被更新或卸载覆盖。.DS_Store、__pycache__ 等文件不算本地修改。

发布渠道​

Skills 和 CLI 二进制一起发布,正式版和开发快照各有独立的版本与 latest 指针:

  • 正式版 CLI 默认读取 https://live-public-aigc-resources.s3.cn-north-1.amazonaws.com.cn/turing/turing-cli/latest/skills/manifest.json。
  • 开发快照默认读取 turing-cli-dev 下的同名路径。

安装前,CLI 会按清单中的 SHA-256 校验完整的 Skill 包,并拒绝跳转到非 HTTPS 地址。CLI 自身的升级见 Upgrade & Version,它和 Skill 更新是两个独立操作。

Memory​

turing-memory 还需要登录并导入 Space 配置。用 skills install 安装后,依次运行:

turing-cli memory login
turing-cli memory install --config ~/turing-agent-memory.json --config-only
turing-cli memory doctor

--config-only 只导入配置,不改动 Agent 目录。也可以不先运行 skills install,直接运行 memory install --config,它使用同一个 Agent 选择器。详见 Memory。

旧版 memory install 留下的副本​

0.4.0 之前的 memory install 把 turing-memory 固定写入 ~/.claude/skills、~/.codex/skills、~/.codebuddy/skills、~/.openclaw/skills 和 ~/.agents/skills,并且不写安装记录。

  • 只有内容与旧版发布的原文逐字节一致的副本,才会被识别为旧版副本;内容不同的同名目录一律按"不是 turing-cli 安装的"处理,不会被覆盖或删除。
  • 再次为对应 Agent 安装 turing-memory 时,旧版副本会被接管。status 会把它显示为 legacy,并给出可以直接执行的接管命令;update 和 remove 会跳过它。
  • 为 Codex 安装时,~/.agents/skills 中的旧版副本会被接管。只要这次安装把新副本写入了 ~/.agents/skills(为 Codex 安装,或为 OpenClaw 同步),已弃用的 ~/.codex/skills 中的旧版副本就会被删除,避免 Codex 同时加载两份。删除前,交互确认会列出这个目录。
自助排查