安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install aiscope-setup
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 aiscope-setup。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

AIScope Setup 指导 AI 编程 agent 完成原生基于 Rust 的 AIScope CLI 的安装、检查可执行文件是否正常工作，并通过非交互式 JSON 扫描审计项目的指令。它有助于避免常见的设置错误，例如下载错误的 CPU 构建版本、使用无关的包，或在验证期间启动交互模式。
该工作流还涵盖了在插件尚未提供时安装 AIScope 的独立 agent skills。对于使用 Openclaw Skills 和其他 agent 环境的开发者，它强调使用当前的 agent 标识符，优先使用项目作用域安装，并确认审计针对的是预期项目，而不更改指令文件。

应用场景

在 Windows、macOS 或 Linux 开发机器上首次设置 AIScope。
在运行项目审计之前诊断缺失或无法正常工作的
aiscope
命令。
根据可用工具和偏好，通过 npm、Python 打包、Cargo 或已验证的发布版本二进制文件安装 AIScope。
当插件未提供独立的 AIScope agent skills 时，将其添加到当前编程 agent 中。
使用非交互式 JSON 扫描检查项目指令，并确认报告的 root 为预期目录。
审查返回的冲突和扫描覆盖范围，同时保持现有的指令文件不变，除非明确要求修改。

工作原理

在安装任何内容之前，先使用 aiscope --version 检查现有的安装。
选择支持的安装途径：下载匹配的发布版本归档文件并验证其 SHA-256 校验和，使用准确的 aiscope-cli npm 或 Python 包，或者在 Rust 和平台链接器可用时从 Cargo 进行安装。
如果需要独立的 agent skills，请使用 skills CLI 和当前的 agent 标识符从 AIScope 仓库进行安装。优先选择项目作用域，在复制前检查现有的 skills，并在插件已提供它们时跳过重复项。
使用 aiscope --version 验证 CLI。
在目标项目目录中，运行 aiscope --specific --json .，无需启动 TUI 或 watch 模式。
将 stdout 解析为 JSON，验证 root 是否与预期的项目目录相匹配，并说明扫描覆盖范围和任何报告的冲突。除非用户要求修改，否则保持指令文件不变。

配置指南

检查 AIScope 是否已安装：
aiscope --version
使用适当的途径安装。对于已发布的可执行二进制文件，请选择适用于操作系统和 CPU 架构的当前发布版本：Windows x86_64、macOS x86_64 或 ARM64，或者带 glibc 的 Linux x86_64 或 ARM64。从同一发布版本下载归档文件及其 .sha256 文件，在解压前比较 SHA-256 校验和，并将可执行文件放在 PATH 上用户可写的目录中。不要假设 Linux musl 兼容性。
对于 Node.js 22 或更高版本，请使用准确的 npm 包和版本：
npm install --global aiscope-cli@0.1.2

或者在不进行全局安装的情况下运行：

npx --yes aiscope-cli@0.1.2 --version
对于 Python，请安装平台 wheel，它打包了可执行文件：
uv tool install aiscope-cli==0.1.2

或者：

pip install aiscope-cli==0.1.2
如果 Cargo 可用，也可以进行源码安装：
cargo install aiscope --version 0.1.2 --locked
Cargo 源码构建需要 Rust 和平台链接器。未经同意，请勿替换用户的 Rust 工具链以解决构建失败问题。优先选择现有的包管理器，除非有要求，否则避免全局安装。正确的 npm 和 PyPI 包名称是 aiscope-cli；名为 aiscope 的无关 npm 包并不是此工具。
要安装独立 skills，请将 codex 替换为当前的 agent 标识符。默认是项目作用域；仅在有要求时使用 --global：
npx --yes skills add Jayanth-MKV/aiscope --skill aiscope-setup aiscope --agent codex --copy --yes
如果 Node.js 不可用，请仅将仓库 skills/ 文件夹中的两个 skill 目录复制到 agent 支持的 skills 目录。在复制前检查现有的 skill 内容，如果插件已提供这两个 skills，请跳过此步骤。
验证可执行文件并从目标项目运行首次审计：
aiscope --version
aiscope --specific --json .
将 stdout 解析为 JSON 并确认 root 识别出了预期的目录。在设置期间请勿启动 TUI 或 watch 模式。全用户范围的指令扫描需要显式的 --user 选择加入。

数据架构

AIScope Setup 不会定义单独的数据存储或生成预设的文件集合。其验证扫描会将 JSON 写入 stdout；设置工作流专门针对预期的项目目录检查 root 值，并要求 agent 汇报扫描覆盖范围和返回的冲突。
Item Location or format Setup guidance
AIScope executable User-writable directory on PATH, or installed through a package manager Match the OS and CPU architecture; verify downloaded release checksums before extraction.
Standalone skills Agent-supported skills directory; project scope by default The repository’s skills/ folder contains the skill directories. Check for existing skills before copying.
Audit result JSON on stdout Run aiscope --specific --json ., parse the output, and verify the root field.
User-wide instructions User-level scope Scan only with the explicit --user opt-in.
Project instruction files Existing project files The setup workflow does not modify them unless changes are requested.

高级特性

支持适用于 Windows x86_64、macOS x86_64 和 ARM64 以及带 glibc 的 Linux x86_64 和 ARM64 的原生发布版本二进制文件；明确避免假设支持 Linux musl。
提供多种安装路径：经过校验和验证的发布版本归档文件、npm、打包的 Python wheels 和 Cargo 源码安装。
npm 首次运行会下载经过校验和验证的二进制文件；后续扫描可以离线运行。
支持为当前 agent 安装独立 skill，默认作用域为项目，仅在明确要求时使用全局作用域。
当插件已提供 skills 时可避免重复，并在复制前检查现有的 skill 目录。
使用非交互式 JSON 扫描进行设置验证，验证报告的项目根目录，并避免启动 TUI 或 watch 模式。
默认保持项目指令不变；全用户范围的指令扫描需要显式的 --user 选择加入。

name: aiscope-setup description: Install AIScope and its agent skills, verify the executable, and run a first noninteractive instruction audit. Use for initial setup or a missing AIScope command.

Set up AIScope

Check aiscope --version before installing. AIScope is a native Rust CLI; running a released binary does not require Rust, Python, Node.js, an account, or an API key.

Use the current release at https://github.com/Jayanth-MKV/aiscope/releases/latest. Match the OS and CPU: Windows x86_64, macOS x86_64/ARM64, or Linux x86_64/ARM64 with glibc. Download the archive and its .sha256 file from the same release, compare SHA-256 before extracting, then place the executable in a user-writable directory on PATH. Do not silently install an incompatible architecture or assume Linux musl support.

With Node.js 22+, use npm install --global aiscope-cli@0.1.2 or npx --yes aiscope-cli@0.1.2 --version. The first run downloads a checksum-verified binary; later scans are offline. With Python, use uv tool install aiscope-cli==0.1.2 or pip install aiscope-cli==0.1.2; platform wheels bundle the executable and need no Rust or Node.js. Prefer an existing package manager and avoid global installation unless the user requests it.

If Cargo is available, the alternative is cargo install aiscope --version 0.1.2 --locked. A source build requires Rust and a platform linker; consult the repository's installation guide if it fails. Do not replace the user's Rust toolchain to resolve a build failure without agreement.

For standalone skills, use the published repository with the skills CLI:

npx --yes skills add Jayanth-MKV/aiscope --skill aiscope-setup aiscope --agent codex --copy --yes

Replace codex with the current agent's identifier. Default to project scope; use --global only if the user requests it. If Node.js is unavailable, copy just the two skill directories from the repository's skills/ folder to the current agent's supported skills directory. Do not overwrite an existing skill without checking it. A plugin already supplies both skills, so skip a duplicate standalone installation.

Verify with aiscope --version, then run aiscope --specific --json . from the target project. Parse stdout as JSON and confirm its root matches the intended directory. Do not launch the TUI or watch mode during setup. Explain scan coverage and any returned conflicts; leave instruction files unchanged unless changes were requested. User-wide instructions require the explicit --user opt-in.

Use the exact npm/PyPI package name aiscope-cli. The unrelated npm package named aiscope is not this tool.

SearchDock 设置

SearchDock