skill-market
管理 Skill 生命周期——列出已装、看详情、搜索市场、 安装、卸载、启用、禁用、更新。当用户表达"装个技能 / 卸载技能 / 看看有什么技能 / 启用禁用技能"意图时使用。
- License 许可
- AGPL-3.0
- 所属仓库
- tabtin-ai/TabTin
- 最近更新
- 2026-10-08
- Stars
- ★ 454
- Forks
- 115
01 前言 Front Matter
- name
- skill-market
- metadata
- { "tabtin": { "tags": [ "skill", "marketplace", "lifecycle" ], "entry": "cli", "category": "collaboration", "autoActivateFor": [ "skill" ] }, "version": "0.1.0" }
- description
- 管理 Skill 生命周期——列出已装、看详情、搜索市场、 安装、卸载、启用、禁用、更新。当用户表达"装个技能 / 卸载技能 / 看看有什么技能 / 启用禁用技能"意图时使用。
02 资源文件 1
- 参考文档references/cli-commands.md4.0 KB
03 SKILL.md 正文
Skill Market Operator
概述
Skill 是 TabTin 平台的能力包(用户 / 应用 / 平台预先写好的"知识包")。本 SKILL 覆盖 Skill 的平台生命周期管理——安装 / 卸载 / 启用 / 禁用 / 详情 / 市场 / 搜索 / 更新。
入口规范:所有操作通过 tabtin skill CLI 触发,由 Agent 通过 run_terminal_command
工具调用。没有对应的 FC 工具——charter §3.1「CLI-first,不是 FC-first」:Skill
生命周期管理以 CLI 命令为唯一对外契约,能管道、能脚本、能复用。FC skills_read /
skill_invoke 只读正文 / 调指令,不负责平台注册表操作。
CLI vs FC 边界(重要)
Skill 域有两套访问面,职责不同,别混用:
| 目的 | 走哪条 | 命令 |
|---|---|---|
| 看本地 SKILL.md 正文(学流程、读方法) | FC | skills_read |
| 看平台元数据(版本 / 安装源 / 启用状态 / 市场信息) | CLI | tabtin skill info <name> |
| 生命周期操作(安装 / 卸载 / 启用 / 禁用 / 更新) | CLI | tabtin skill install/remove/enable/disable/update |
| 列已装 / 搜市场 / 看市场 | CLI | tabtin skill list / tabtin skill search / tabtin skill market |
误用排查:
- 想知道"XX 技能怎么用"→ 读正文 → FC
skills_read,不是tabtin skill info(info 只给版本/状态)。 - 想知道"XX 技能装没装 / 什么版本 / 启没启用"→ 看元数据 → CLI
tabtin skill info,不是skills_read。 - 想装 / 卸 / 启用 / 禁用 → CLI 生命周期命令,不是 FC(FC 没有这些能力)。
方法路由
| 目标 | CLI 命令 |
|---|---|
| 列出已装 Skill | tabtin skill list |
| 看 Skill 详情(版本 / 安装源 / 启用状态) | tabtin skill info <canonical-key> |
| 看 Skill 市场 | tabtin skill market |
| 看当前 Agent 已启用 / 可见 Skill | tabtin skill managed(对齐 Wave 1 visible) |
| 搜索 Skill(按关键词) | tabtin skill search <query> |
| 安装 Skill | tabtin skill install <canonical-key> |
| 卸载 Skill | tabtin skill remove <canonical-key> |
| 启用 Skill | tabtin skill enable <canonical-key> |
| 禁用 Skill | tabtin skill disable <canonical-key> |
| 更新 Skill | tabtin skill update <canonical-key> |
何时调用本 Skill
调用时机:用户表达"管理技能"意图——装 / 卸 / 启用 / 禁用 / 看详情 / 看市场 / 搜索。
| 用户表达 | 推荐命令 |
|---|---|
| "装个 web-search 技能" | tabtin skill install user:web-search |
| "装 Office Pack 会议纪要技能" | tabtin skill install app:tabtin-office-skills-pack/meeting-notes-to-actions |
| "卸载 XX 技能" | tabtin skill remove user:xx |
| "看一下 XX 技能的详情" | tabtin skill info user:xx |
| "我装了哪些技能?" | tabtin skill list |
| "有什么技能可用?" | tabtin skill market 或 tabtin skill search <query> |
| "启用 / 禁用 XX 技能" | tabtin skill enable user:xx / tabtin skill disable user:xx |
| "更新 XX 技能" | tabtin skill update user:xx |
关键判别:用户说的是"管理技能本身"(装/卸/启/禁/看状态)还是"用技能干活"。
前者走本 SKILL(CLI 生命周期);后者读对应 skill 的正文(FC skills_read)再行动。
CLI 命令
每个子命令的完整 flag、参数约束与示例(list / info / market / managed / search / install / remove / enable / disable / update)见
references/cli-commands.md。
注意事项
- 装 / 卸 / 启用 / 禁用走 CLI,不是 FC:这些是平台注册表操作,走
tabtin skillCLI;不要用 FCskills_read/skill_invoke代替——它们是读正文 / 调指令,不是 生命周期管理。 - 看正文 vs 看元数据:想学 skill 的流程走 FC
skills_read;想看版本 / 安装源 / 启用状态走 CLItabtin skill info。两者数据源不同,互相不能替代。 - 安装 = 启用(Wave 1):
install与enable都打POST /skills/{key}/enable, 设备端随后物化本地文件;不需要再单独enable。 - canonical key:参数必须带 source 前缀(
user:/app:/ …),例如user:web-search、app:tabtin-office-skills-pack/meeting-notes-to-actions。 - 卸载 vs 禁用:
remove= disable + 删 enablement + 清本地文件;disable只停用、保留安装记录与本地文件。 - install / remove / update / enable / disable 是 RiskWrite:会改注册表或本地物化,需用户知晓。RequiresAgent。
- search 用关键词、market 看全量:用户说"搜一下 X 技能"走
search <query>; "看看有什么技能"走market(全量市场)或list(已装)。
Risk Level
| 命令 | risk_level | 含义 |
|---|---|---|
list / info / market / managed / search |
safe | 只读 |
install / remove / update |
review | 改注册表(RiskWrite),需用户知晓 |
enable / disable |
review | 影响运行时启用状态 |
资源导航
references/cli-commands.md:当你需要核对tabtin skill子命令的完整 flag、参数约束或示例时读取。
04 同仓库更多 Skills
tabtracker
管理自动化任务——创建、列出、暂停、恢复、立即触发(产品模块名「自动化」, 具体条目称「自动化任务」;CLI 命令仍为 tabtin tracker)。当用户表达"派活"意图时使用: 关键词包括"帮我..."、"以后..."、"每天..."、"工作日..."、 "提醒我..."、"定时..."、"每周..."。区分一次性指令(直接执行)和长期任务(创建 自动化任务,由调度器在指定时间唤起 Agent)。
tabtin-project
在 Project Task 执行会话中工作:先读取当前任务工作面,再优先修改既有中间产物。 当系统上下文表明当前会话是 Project Task,或用户要求继续修改过程中的中间产物时使用。
tabtin-widget
渲染可视化组件——用 show_widget 编译 SVG / HTML(no-script) / Mermaid 图做自由可视化。内容能落 present_to_user 4 类 kind → 不用 widget;长期可编辑产物 → TabData/ TabDoc/TabSlide。
resource-link
插入资源链接——在 chat 文字流里给资源链接,markdown link 形态 [显示文本](tabtin://resource/<type>/<id>?hint=<carrierApp>), 用户点击直接在 Space 内打开。行业格式(http/https/ file/mailto)也兼容;不要写 file:// 让用户自己复制粘贴。
mcp-operations
操作本机 MCP 连接——通过 `tabtin mcp` CLI 查看当前 Space 已挂载的本机 MCP servers、tools/resources/ prompts,并用 `mcp_call_tool` 调用指定 MCP tool。 用户提到"使用 Playwright MCP""调用本机安装的 MCP 工具""读取某个 MCP resource""获取某个 MCP prompt"时激活。
file-generation
生成办公文件——在当前工作目录生成 Office / PDF 文件(xlsx / docx / pptx / pdf;用户说 ppt 时按 pptx 处理)并发布成聊天卡片。用户要"导出 / 生成 Excel 表格、Word 文档、PPT 演示、PDF 报告""做一份报表 / 合同 / 周报文件""把这些数据存成 xlsx"时激活。