skill-market

name	skill-market
description	管理 Skill 生命周期——列出已装、看详情、搜索市场、 安装、卸载、启用、禁用、更新。当用户表达"装个技能 / 卸载技能 / 看看有什么技能 / 启用禁用技能"意图时使用。
metadata	{"version":"0.1.0","tabtin":{"category":"collaboration","autoActivateFor":["skill"],"entry":"cli","tags":["skill","marketplace","lifecycle"]}}

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 skill CLI；不要用 FC skills_read / skill_invoke 代替——它们是读正文 / 调指令，不是 生命周期管理。
• 看正文 vs 看元数据：想学 skill 的流程走 FC skills_read；想看版本 / 安装源 / 启用状态走 CLI tabtin 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、参数约束或示例时读取。