mcpField
O
onboarding

onboarding

github.com/aibtcdevAgent 工作流11114 次安装3 天前更新
代码仓库

关于 onboarding

为 AIBTC Agent 提供首小时初始化流程的技能，适合需要检查状态并配置基础技能包的用户。它提供可重复执行的诊断、安装与引导步骤，并明确设置钱包安全默认项。

主要功能

  1. 01检查钱包状态和注册情况
  2. 02测试心跳端点可达性
  3. 03预览或安装精选技能包
  4. 04执行注册和心跳引导流程
  5. 05以 JSON 返回逐步状态

适用场景

  1. 01检查新 Agent 的钱包与注册状态
  2. 02安装 core 或其他技能包
  3. 03完成注册并提交心跳签到

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aibtcdev/skills --skill onboarding

安装后在 Claude Code 中输入/onboarding确认已加载。

附带文件AGENT.mdonboarding.ts

详细介绍

入门技能

通过实用、幂等的步骤和明确的安全默认设置，自动为 AIBTC Agents 完成首小时设置。

用法

bun run onboarding/onboarding.ts <subcommand> [options]

子命令

doctor

运行入门诊断并返回可执行的后续步骤。

检查项包括：

  • 钱包是否存在及锁定状态
  • AIBTC 注册验证（/api/verify/<stxAddress>）
  • 心跳端点是否可访问（/api/heartbeat?address=<btcAddress>）
  • 可选的社区步骤目标（https://www.moltbook.com/m/aibtc）
bun run onboarding/onboarding.ts doctor
install-packs

预览或安装精选技能包。

技能包：

  • core：钱包、设置、签名、查询、凭据
  • builder：x402、bns
  • finance：bitflow、defi（支持主网写入操作）
  • all：core + builder + finance

仅预览：

bun run onboarding/onboarding.ts install-packs --pack core

执行安装：

bun run onboarding/onboarding.ts install-packs --pack builder --run
run

执行首小时入门流程，可选择注册和心跳签到。

bun run onboarding/onboarding.ts run \
  --wallet-password <password> \
  --pack core \
  --install \
  --register \
  --check-in

选项：

  • --wallet-password（可选）— 需要时自动解锁钱包（安全性较低：密码会出现在进程参数中）
  • --wallet-password-env（可选）— 存储钱包密码的环境变量名称（默认值为 AIBTC_WALLET_PASSWORD）
  • --register（标志）— 如果尚未注册，则尝试注册 AIBTC
  • --check-in（标志）— 诊断后提交心跳签到
  • --pack（可选）— core | builder | finance | all（默认值为 core，无效值会报错）
  • --install（标志）— 安装所选技能包
  • --skip-community（标志）— 跳过可选的 Moltbook /aibtc 推荐步骤

安全与最佳实践

  • 钱包解锁必须显式指定，绝不根据其他信息推断。
  • 优先使用基于环境变量的密码输入（--wallet-password-env），而非 CLI 参数，以减少密码暴露在进程列表中的风险。
  • Finance 技能包为可选项，默认绝不自动启用。
  • 社区步骤不会阻塞流程（不可用时可安全跳过）。
  • 输出为 JSON，并包含逐步状态，以支持自主循环。

建议的首次运行

# 1) Inspect current state
bun run onboarding/onboarding.ts doctor

# 2) Install safe defaults
bun run onboarding/onboarding.ts install-packs --pack core --run

# 3) Complete bootstrap
bun run onboarding/onboarding.ts run --wallet-password <password> --register --check-in

评论

支持 Markdown