SuperAPI AI 工具集

blocklet

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:该技能帮助用户在不阅读 monorepo 的情况下,发现、脚手架、构建和检查 Arc blocklet。blocklet 是可安装的 AFS 应用,由 manifest 和可选的 AUP 页面/智能体组成。

主要能力:发现方面提供 arc --help、arc blocklet --help、arc blocklet recipe list、arc blocklet recipe explain <name>(如 basic、blog、agent、minimal-app)、arc blocklet list [dir]、arc blocklet inspect <path|ref>、arc blocklet check <dir>。守护进程启动后,可用 arc afs ls /blocklets --instance <name> 查看实时目录,arc afs ls /registry/blocklets --instance <name> 查看注册表条目,arc afs explain /blocklets --instance <name> 获取说明。

脚手架:在空的隔离目录中操作,不要写入 monorepo 根目录。示例:mkdir -p /tmp/my-blocklet && cd /tmp/my-blocklet,然后 arc blocklet create . --name my-blocklet --recipe basic。basic 只生成 blocklet.yaml;--name 会成为 DID 标识符,仅允许字母数字、连字符和下划线;省略时从目录名派生,若 create 拒绝(退出码 5)则不会写入会被 build 拒绝的 DID。之后运行 arc blocklet check . 和 arc blocklet build .,生成 dist/ 目录,含 .afs/manifest.json 和 blocklet.dist.json。更丰富的 recipe 包括 blog(AUP 博客页面)、agent(AI 聊天加智能体)、minimal-app(web 加 aup 加 agent 加设置)、agent-workspace、support-community。

部署与运行:构建后可用 arc blocklet deploy --help、arc blocklet run --help、arc blocklet instance list、arc blocklet instance deploy --help。云/Pages 部署需要项目凭据,缺少密钥时应失败关闭。

安装:arc skill install blocklet 会写入 .agents/skills/blocklet/SKILL.md 和 .claude/skills/blocklet/SKILL.md。

限制:该资料为 L0 级别,需用 arc blocklet <cmd> --help 验证标志;除默认实例外,每个 arc afs 调用需加 --instance <name>;具体 recipe 文件列表建议以实时 explain 或 /.knowledge 为准。