aicskills

README

aic-skills

AIC 官方技能内容仓。技能 = SKILL.md + 可选 ui/、api/、tables/、cli/ + 普通资源； Go embed 携带静态内容与设备程序源码，随平台（aic）与设备端（aic-pod）构建分发。

中文 | English

内建技能

技能	版本	形态
browser	1.1.3	说明 + UI：设备侧官方 agent-browser（0.38.2）MCP 的用法与实时画面
cua	1.1.1	说明 + UI：官方 cua-driver（0.33.2）MCP 的远程查看与控制
blender	0.3.1	说明：设备上的 Blender 直连（看场景 / 渲染 / 执行 Python）
create	1.0.3	手册 + 模板 + 介绍页：AIC 扩展作者手册（云端/界面/设备三端）与给人看的扩展能力介绍页
office_studio	1.0.4	说明 + UI：Office 文档工作台
drawio	1.0.3	说明 + UI：DrawIO 绘图工作台
ppt_studio	1.0.4	说明 + UI：PPT 工坊
video_studio	1.0.3	说明 + UI：视频工坊
play_with_ai	1.0.4	说明 + UI：与 AI 对弈的多游戏台（五子棋 / 象棋）
vhtml	0.5.1	说明：vhtml 前端框架指南
hello	1.0.1	示例：普通原生 CLI

builtin_embed.go 的 embed 列表是唯一的发布面——目录存在但不在列表里 就不会发布。

边界

• 说明、UI 与云端 API 由平台发布和使用；技能本身没有 installed / enabled / 进程 / 服务状态。
• 普通 CLI 与脚本按说明原生执行，由用户自行下载安装；cli/ 则可包含设备服务 manifest.json 与程序源码。仓内不带二进制、构建产物或 provider / SDK。
• 有状态软件经 vtools 注册成设备服务命令：Browser/CUA 使用 MCP，Blender 使用 vtools/tcp。 官方内嵌清单由 Pod 启动时读取；第三方服务由设备 mcp.servers 配置，用户包的自动安装与注册链路尚未开放。
• 技能页面入口与 HTTP 包服务同段：/skills/cloud/{id}（对齐 /fs/cloud——裸入口加载包内 ui/index.html，同段又是包服务）；子页 /skills/cloud/{id}/{page}，详情与管理 /skills/detail/cloud/{id} （按 role 自动分派；成员 /members、数据 /data）。页面用 url_prefix / $mod.scoped 定位资源，不要硬编码平台地址。 注意 fs 工具路径仍是 /skills/{id}/...（与 URL 不同段，勿混用）。

消费方式

平台侧由 aic 的 skills.builtin 维护事件定版：首装整包落盘并建行（id = 包名、属主 system、公开）。事件指纹由「包名 + 内嵌 version」组成；指纹变化触发执行，管理员也可强制重跑。 执行时不再比较行版本，而是把全部内嵌包无条件整目录原子交换并全量刷新行元数据；因此内容变更必须 bump 对应技能版本以改变指纹。设备端共用同一份 embed，无需下载。

go get github.com/veypi/aic-skills@latest

测试

go test ./...                # 嵌入清单、元数据、版本、打包

cd browser/ui && npm test    # 页面测试（零依赖，node --test）
cd cua/ui && npm test
cd play_with_ai/ui && npm test

# 根 Go 测试同时覆盖两个真实 MCP 示例（initialize + tools/call）
GOWORK=off go test ./...

版本面

• 模块版本：VERSION 与 tag vX.Y.Z，变更见 CHANGELOG.md—— Go 依赖面，消费方（aic 与 aic-pod）据此解析。
• 技能版本：各 SKILL.md frontmatter 的 version:——内容版本，也是 skills.builtin 指纹的组成部分；内容变更必须 bump 以触发自动定版（事件执行后无条件覆盖，不做版本大小比较）。

贡献者与 AI 代理须知（契约与不变量）见 AGENTS.md；文档地图见 docs/index.md。

许可

MIT（LICENSE）。

Documentation

Overview

Package aicskills embeds the official static skill catalog for cloud publication.

Index

• func Frontmatter(doc []byte) (name, version string)
• func List() []string
• func Open(name string) (fs.FS, error)
• func Version(name string) string
• func Zip(name string) ([]byte, error)

Functions

func Frontmatter

func Frontmatter(doc []byte) (name, version string)

Frontmatter 读 SKILL.md frontmatter 顶层 name/version（`---` 围栏内 无缩进 `key: value`；不引 yaml 依赖，只取两个标量键）。宽松提取，仅供 内嵌场景取版本真相（本包 Version）；aic 侧 完整契约走 skillhub parseSkillMD（yaml KnownFields 严格解析），两端各取 所需——frontmatter 字段契约真相 = aic docs/reference/skill.md §1。

func List

func List() []string

List 内建包名（嵌入根下的目录名 = 包名 = 注册表 id）。按名排序，遍历稳定。

func Open

func Open(name string) (fs.FS, error)

Open 包目录子树（只读；name 须为 List 成员）。

func Version

func Version(name string) string

Version 包版本（SKILL.md frontmatter version 标量；无 = ""）。

func Zip

func Zip(name string) ([]byte, error)

Zip creates a content archive with paths relative to the skill root.