Crunch 协议 CLI 技能

将自然语言查询翻译为 crunch-cli 命令。支持配置文件（profiles）及面向 Slack、Telegram、Discord 或纯文本的输出格式化。

前置条件

• Node.js 18+ 及其配套的 npm
• Solana 钱包密钥对（用于链上操作）

包安装

该技能通过 npm（全局方式）安装依赖包：

包安装的智能体规则：

• 仅从官方 npm 仓库安装 @crunchdao/crunch-cli
• 禁止使用自定义 registry URL —— 不得使用 --registry 参数覆盖默认源
• 若尚未安装，须先征得用户同意 后再执行安装

凭证配置

Solana 钱包密钥对（链上操作必需）

• 含义：一个包含 Solana 私钥的 JSON 文件，用于对交易签名
• 配置方式：通过 crunch-cli config set wallet /path/to/wallet.json 设置，或在每条命令中使用 -w 标志指定
• 存储位置：由用户自行管理的本地文件；其路径记录在 ~/.crunch/config.json 中

钱包相关智能体规则：

• 除非用户明确要求且已充分理解安全风险，否则不得创建或生成钱包密钥对
• 不得读取或显示 钱包密钥对文件的内容
• 严禁将钱包文件提交至 Git 仓库 —— 必须始终确认 .gitignore 已将其纳入忽略列表
• 必须向用户主动询问钱包路径 —— 不得擅自假设或扫描查找密钥对文件

配置文件（~/.crunch/config.json）

• 按 profile 存储网络、钱包路径与 RPC URL
• 通过 crunch-cli config 系列命令进行管理，无需手动编辑
• 除非用户明确要求，否则不得修改或删除现有 profile

初始化设置

npm install -g @crunchdao/crunch-cli
crunch-cli --version

Profile 管理

CLI 内置基于 ~/.crunch/config.json 的 profile 管理功能：

crunch-cli config show                    # 显示当前配置
crunch-cli config active                  # 显示解析后的生效配置项
crunch-cli config list-profiles           # 列出所有可用 profile
crunch-cli config save-profile      # 将当前配置保存为指定名称的 profile
crunch-cli config use            # 切换至指定 profile
crunch-cli config set         # 设置某项配置值

可通过全局标志（flag）在单条命令中覆盖配置：

自然语言短语到 CLI 命令的直接映射

执行流程

1. 解析（Parse） —— 识别动作、目标、名称/标识符及参数
2. 解析 Profile —— 若用户提及 profile，则切换或使用对应命令行标志
3. 映射（Map） —— 查阅上述短语映射表确定具体命令
4. 执行（Execute） —— 运行对应 CLI 命令
5. 格式化（Format） —— 按请求渠道（Slack / Telegram / Discord / 纯文本）组织输出内容

输出格式化规则

根据用户请求中的上下文（如 “for slack”、“telegram format” 等）自动识别目标平台：

• Slack： 使用 *bold* 表示加粗、• 表示项目符号、━ 表示分隔线
• Telegram： 使用 bold 表示加粗，并可添加 emoji 前缀
• Discord： 使用 ## headers 表示二级标题、**bold** 表示加粗
• 纯文本： 使用简洁的 key: value 键值对格式

错误处理

若命令执行失败，应提供如下常见问题修复建议：

• 网络配置错误？尝试添加 -n mainnet-beta 或 -n devnet
• 缺少钱包？请添加 -w /path/to/wallet.json
• 资源未找到？运行 crunch-cli crunch list 查看可用项列表

Coordinator 节点初始化

快速搭建一个新的竞赛工作区：

crunch-cli init-workspace my-challenge

该命令将生成完整的节点工作区结构。如需进一步定制，请参考 coordinator-node-starter 技能。

参考文档

完整 CLI 文档详见：references/cli-reference.md