obelisk-installer

安装 Obelisk

这是一次性引导指南。它会安装本地 Obelisk 运行时，然后使用该运行时从 github.com/tommy0103/obelisk-skill 安装官方 Agent 技能。

1. 检查 CLI

command -v obelisk >/dev/null 2>&1 && obelisk --version

如果成功，请跳至第 3 步。除非用户要求升级或修复，否则不要重新安装可用的 CLI。

2. 安装 CLI

安装全局命令会更改用户的计算机。运行以下官方安装方式之一之前，请向用户展示命令并征求其同意。

使用 npm：

npm install --global @obelisk-apps/cli

在 macOS、Linux 或 WSL 上，官方安装程序会执行相同的仅安装 CLI 操作，且绝不会安装 Agent 技能：

curl -fsSL https://raw.githubusercontent.com/tommy0103/obelisk/main/install.sh | sh

绝不要使用 sudo、安装守护进程，或从其他来源下载 Obelisk。

验证安装结果：

obelisk --version

3. 选择技能安装范围

标准技能安装程序默认安装到当前项目。运行前，请告知用户此默认设置，并询问是否应安装 /obelisk：

• 仅用于当前项目 — 只能在运行安装程序的项目中使用。
• 全局 — 可在用户的所有项目中使用。

不要默默选择当前项目这一默认设置。如果用户已明确说明范围，请直接按其选择操作，无需再次询问。

根据用户的回答运行相应命令：

当前项目：

obelisk install

全局：

obelisk install --global

传递用户要求的任何其他目标选项。该命令使用标准技能安装程序，因此请按照其提示操作，不要手动复制技能文件。

安装完成后，如果未立即发现新的 /obelisk 技能，请告知用户重新加载其 Agent。本文档仅用于引导安装，不是查询技能，不得自行回答有关会话历史的问题。