mcpField
C
cyrus-setup-prerequisites

cyrus-setup-prerequisites

github.com/cyrusagents开发8791.0k 次安装今天更新
代码仓库

关于 cyrus-setup-prerequisites

检查系统依赖并安装 cyrus-ai 的准备技能,指导选择包管理器、设置可选的浏览器自动化工具,并验证命令行工具是否安装成功。

主要功能

  1. 01检查 Node.js、jq 和 GitHub CLI
  2. 02提供缺失依赖的安装步骤
  3. 03检查可选的 agent-browser
  4. 04使用所选包管理器安装 cyrus-ai
  5. 05验证命令行工具并创建配置目录

适用场景

  1. 01为 Cyrus 设置准备系统环境
  2. 02安装缺少的运行时和集成依赖
  3. 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

对于每个缺失的依赖项,提供安装命令:

依赖项macOSLinux/Ubuntu
Node.jsbrew install nodecurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs
jqbrew install jqsudo apt install -y jq
ghbrew 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