Skill Manager
技能管家,三大能力:发现安装 → 沉淀复用 → 治理维护。
遵循生态标准(SKILL.md + 宿主原生 skills 目录),纯文件驱动,零外部依赖。
核心红线
- 元技能定位:本 skill 不直接完成业务任务,只管理其他技能。
- 对齐宿主,不另造轮子:技能单元统一为
<skills目录>/<name>/SKILL.md,由宿主 Agent 原生扫描触发。不自建匹配算法(宿主已原生实现)。 - 禁用靠物理隔离,不靠字段:宿主直接扫目录、不读我们的 registry,因此禁用 = 移入
<skills目录>/.disabled/<name>/(点开头目录被宿主忽略),启用 = 移回。 - registry 是账本不是开关:
registry.json只记来源/版本/时间/启用状态,丢失不影响技能可用,只影响治理能力。真相源是文件的物理位置。 - 示例默认禁用:3 个示例技能部署到
.disabled/,用户显式启用才生效。 - 安全优先:远程技能装前做来源与危险意图检查;任何脚本禁止管道直接执行(
curl … | bash一律拒绝),须先落盘、展示、确认。
流程主线
阶段 1 · 定位 skills 目录
- 做什么:识别宿主 Agent,确定其原生 skills 目录;不支持原生则回退项目
.skills/。 - 读文件:
references/adapters/<平台>.md - 完成标志:目标目录已确定并存在。
阶段 2 · 部署治理资产
- 做什么:部署
_template/、registry.json,示例技能部署到.disabled/。 - 读文件:
references/install.md - 完成标志:目录就位,
registry.json合法,示例处于禁用位置。
阶段 3 · 注入治理协议
- 做什么:把
references/prompt.md按平台规则注入上下文,使 Agent 获得沉淀/治理能力。 - 完成标志:Agent 可响应"沉淀技能""列出技能""禁用技能"等指令。
阶段 4 · 验证收尾
- 做什么:让用户说"列出已安装技能"验证;询问是否启用示例。
- 完成标志:输出
[Skill] 技能管理系统已就绪,skills 目录: {path}。
按需读取(渐进式披露)
| 何时读 | 文件 |
|---|---|
| 执行治理操作(沉淀/启用/禁用/卸载/升级) | references/prompt.md |
| 首次部署、卸载整套系统 | references/install.md |
| 用户要找现成技能、需要远程搜索安装 | references/remote-search.md |
编写/校验 SKILL.md 格式与字段 |
references/skill-format.md |
| 安装第三方技能前的安全审查 | references/security.md |
| 确定平台 skills 目录与注入位置 | references/adapters/ |
| 新建技能的起始模板 | resources/skill-package/_template/SKILL.md |
| 内置示例(commit-message / code-review / api-doc-gen) | resources/skill-package/examples/ |
> 与 find-skill-skillhub 的关系:本 skill 覆盖发现 + 沉淀 + 治理全链路,是超集。发现能力(references/remote-search.md)覆盖 SkillHub / GitHub / npm 多源,与 find-skill 单源检索有重叠;但发现之外,本 skill 额外提供沉淀自有技能与全生命周期治理。只装本 skill 即可自足,二者也可共存。