用途:该技能面向 10xDevs 学习者,用于准备用户命令行环境与项目,再把可用的工作上下文交给 10x-cli-guide。选择版本、安装辅助工具或运行课程命令前,需先阅读兼容性参考;判断已安装 CLI 支持什么,应以实际运行器的 help 与对应已发布源码为准,而非变动的 master README。
主要能力与流程:
- 确认项目与既有安装:先识别目标项目目录、shell 和 AI 工具;用 command -v 10x、10x --version 及 --help、get --help、sync --help、auth --help 检查运行器,记录可执行路径与安装方式。已有可用安装无需重装或重新登录。可查看项目 .10x-cli.json 与 profile manifest 作为本地元数据,不做编辑。
- 选择兼容运行器,必要时才安装:按参考中的版本与能力检查执行,记录实际包版本、源码修订与支持的语法。npm/npx 方式需按该包的 engines 校验 Node(所检查基线要求 Node 20+)。无合适全局 CLI 时可使用固定的 npx 运行器,避免全局安装。安装或更新后需重跑 version/help,全程保持同一精确运行器。
- 认证与课程可用性分开检查:运行所选用运行器的 auth --status,同时查看会话有效性与实时访问状态;仅当需要登录时,让用户在交互终端运行已验证的 auth 命令并完成其展示流程(所检查版本使用邮件或 Circle 消息的 magic link)。不要索取邮箱、代开链接或读取 auth.json/token。
- 就绪检查:运行 doctor --json,读取 data.checks 与 data.overall 及退出状态;外层 status: "ok" 只是输出信封。新项目首次下载前缺少 .claude/ 可能属正常,不要为让检查变绿而造目录。
- 交接给 guide:定位项目内已安装的 10x-cli-guide/SKILL.md 及其 references/compatibility.md,缺失时按所选渠道安装并核实。随后在对话中传递不含密钥的紧凑上下文,并由 guide 继续课程流程。
适用场景:10xDevs 课程环境的 CLI 安装、升级、认证、项目绑定与就绪排查。
限制:不得静默套用特定上下文(如 macOS/zsh、10xdevs4、claude-code、pl)到其他项目或 profile;存在权限错误时不自动 sudo;离线时无法验证发布、访问与下载状态;未发布的 10x helpers install 命令在所检查的 1.21.0/1.22.0 基线中不存在,需先查实际运行器的 helpers --help。具体收费、价格等资料未提供。