关于 cyrus-setup-prerequisites
检查系统依赖并安装 cyrus-ai 的准备技能,指导选择包管理器、设置可选的浏览器自动化工具,并验证命令行工具是否安装成功。
主要功能
- 01检查 Node.js、jq 和 GitHub CLI
- 02提供缺失依赖的安装步骤
- 03检查可选的 agent-browser
- 04使用所选包管理器安装 cyrus-ai
- 05验证命令行工具并创建配置目录
适用场景
- 01为 Cyrus 设置准备系统环境
- 02安装缺少的运行时和集成依赖
- 03安装或验证 cyrus-ai
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cyrusagents/ cyrus --skill cyrus-setup-prerequisites安装后在 Claude Code 中输入/cyrus-setup-prerequisites确认已加载。
详细介绍
重要:切勿对 ~/.cyrus/.env 或 ~/.cyrus/ 内的任何文件使用 Read、Edit 或 Write 工具。只能使用 Bash 命令(grep、printf >> 等)与环境变量文件交互——绝不能将机密读入对话上下文。
设置先决条件
检查系统先决条件并安装 cyrus-ai。
步骤 1:检测包管理器
如果用户尚未指定首选包管理器,请询问:
你偏好使用哪个包管理器? npm、pnpm、bun 还是 yarn?
保存答案,以便在此技能和后续技能中使用。
步骤 2:检查系统依赖项
运行以下检查并报告结果:
# Node.js >= 18
node --version
# jq (required for Claude Code parsing)
jq --version
# GitHub CLI (required for GitHub integration)
gh --version
对于每个缺失的依赖项,提供安装命令:
| 依赖项 | macOS | Linux/Ubuntu |
|---|---|---|
| Node.js | brew install node | curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs |
| jq | brew install jq | sudo apt install -y jq |
| gh | brew install gh | 参见 https://github.com/cli/cli/blob/trunk/docs/install_linux.md |
如果所有依赖项都已安装,请为每项打印一个勾号并继续。
如果有任何依赖项缺失,请提出为用户安装(通过 uname 检测操作系统)。安装前等待用户确认。
步骤 3:检查 agent-browser(可选)
如果用户选择了任何集成界面(Linear、GitHub、Slack),请检查是否安装了 agent-browser:
which agent-browser
如果已安装,请确保其为最新版本:
npm update -g agent-browser
如果未找到,请告知用户:
agent-browser是可选项,但可用于自动创建 Linear/GitHub/Slack 应用。若未安装,系统将引导你手动完成设置。安装命令:
npm install -g agent-browser
不要因此阻止流程——它是可选项。记录其是否可用,以供后续技能使用。
步骤 4:安装 cyrus-ai
检查是否已安装:
which cyrus
如果未找到,请使用用户首选的包管理器安装:
# npm
npm install -g cyrus-ai
# pnpm
pnpm install -g cyrus-ai
# bun
bun install -g cyrus-ai
# yarn
yarn global add cyrus-ai
验证安装:
cyrus --version
步骤 5:确保 ~/.cyrus 目录存在
mkdir -p ~/.cyrus
如果 ~/.cyrus/.env 已存在,请记录这一点,并告知用户现有值将予以保留。
完成
打印摘要:
Prerequisites:
✓ Node.js v22.x
✓ jq 1.7
✓ gh 2.x
✓ cyrus-ai installed
✓ agent-browser available (or: ⚠ not installed — manual setup mode)
评论
支持 Markdown