技能

SenseCraft CLI 天生为智能体而设计，连接的桥梁就是一组技能：随 CLI 的 npm 包一起分发的普通 SKILL.md 文件。智能体读到它们，就知道该执行什么命令、每个命令族对应哪种授权方式、什么时候该停下来问你——不用你把参考资料一段段粘进对话。

安装配置的第 1 步提到“重启你的 AI 工具，确保所有技能完整加载”。本页就是这句话背后的接入说明。

技能放在哪里

来源二选一，以 npm 包为准：

• npm 包——装完 CLI 就在你的机器上：$(npm root -g)/@seeed-studio/sensecraft-cli/skills/
• 源码仓库——公开的 sensecraft-cli 仓库里的 skills/。npm 包是已安装 CLI 实际加载的内容；公开仓库可能领先于已发布的包。

技能清单

技能	作用
sensecraft-ai	**路由技能——先加载这个。**把任务分派到对应的领域技能和授权方式
sensecraft-data	SenseCAP 设备 / 分组 / 数据
sensecraft-apps	CodeCraft Hub 应用——发布 / 下架 / 删除
sensecraft-apps/create-app	sensecraft-apps 的子技能：把完成本地项目变成应用，之后通过清单做本地优先更新
sensecraft-models	模型库
sensecraft-files	文件上传
sensecraft-devices-cloud	Jetson / 云端开发套件
sensecraft-recamera	为经典款 reCamera 挑选应用和模型、打开烧录页

sensecraft-train 和 sensecraft-fleet 技能，以及内部仓库根目录的 sensecraft-cli 技能，属于内部/开发构建，不在公开的 0.2.x 包里。

create-app 子技能

sensecraft-apps/create-app 是嵌套子技能：sensecraft-ai 路由到 sensecraft-apps（CodeCraft Hub 应用领域），create-app 负责“从项目到应用”的流程。它是 sensecraft-apps/ 里的一个文件夹，所以上面的软链接循环会自动带上它——不需要额外接线。

这个技能在项目根目录维护 sensecraft-app.json 清单，作为唯一事实来源。它记录 app id、上次推送的版本和内容哈希：重试不会创建重复应用；之后在 Console 里做的修改会以 drift 形式呈现，而不是被静默覆盖。项目没有 git 时，技能还会在 .sensecraft/archive/ 写带时间戳的快照。

流程分四步：

1. 收集——读取项目，只做一轮汇总提问（scene、BOM、clone/commerce 开关、封面）。
2. 校验——按模板写出清单，运行随附的校验脚本和离线 schema app fields / app blocks。
3. 创建——上传图片和固件，然后用 app create --from-json 一次性创建应用（创建不属于 L2）。
4. 本地优先更新——修改清单，与远端应用对比（app view --sketch），在一次批量确认后只推送变化的区块。

发布、下架和删除仍归父技能 sensecraft-apps——它们涉及发布声明。克隆是普通的 CLI 命令（app clone --id <app_id> --yes），不属于这个子技能。子技能停在私有草稿；发布是单独的确认步骤。create-app 从 CLI 0.2.1 起随包提供——如果目录不存在，先运行 sensecraft-cli update。完整流程见把项目变成应用。

接入你的工具

Claude Code

bash

  # project-level (recommended — travels with the repo)
mkdir -p .claude/skills
for d in "$(npm root -g)/@seeed-studio/sensecraft-cli/skills"/*; do
  ln -s "$d" ".claude/skills/$(basename "$d")"
done

  # or user-level
mkdir -p ~/.claude/skills
ln -s "$(npm root -g)/@seeed-studio/sensecraft-cli/skills/sensecraft-ai" ~/.claude/skills/sensecraft-ai

Cursor

你可以把 sensecraft-cli 仓库直接作为工作区打开（Cursor 会读取 skills/），也可以把技能目录软链接到 Cursor 的技能目录（常见位置为 ~/.cursor/skills/，具体以你所装 Cursor 版本的设置为准）：

bash

mkdir -p ~/.cursor/skills
for d in "$(npm root -g)/@seeed-studio/sensecraft-cli/skills"/*; do
  ln -s "$d" ~/.cursor/skills/"$(basename "$d")"
done

Codex、opencode、pi 以及其他工具

这些技能就是普通的 SKILL.md 目录，不含任何厂商专属指令。如果工具能自动发现技能，把目录放进它的发现路径即可；如果不能，就把 skills/sensecraft-ai/SKILL.md 和任务对应的领域技能一并加入项目上下文。

两条须知

• **智能体必须能执行 shell 命令。**只能对话的工具可以读取技能，却无法真正操作你的云端账号——这种情况它应当直说，不能假装能做到。
• 接入完成后重启智能体，技能才会生效。

技能跟着 CLI 一起升级

技能打包在 npm 包里，用 npm install -g @seeed-studio/sensecraft-cli@latest 升级 CLI 时，技能也同步更新——新命令、新规则一次到位。用软链接的话无需处理，已是最新；如果是复制的目录，每次升级后要重新复制（并重启智能体）。

之后回到安装配置第 3 步跑通你的第一个任务，或去看看使用场景。