Skill 开发工具包(skill-devkit)
空仓一次初始化,或收编已有无规范技能:版本控制、冻结基线、升级记录、变更门禁、触发词、一键打包、发布审计。问完即落盘,本包退场。
一次对话写进文件夹的不是一篇 SKILL.md,而是一套能自己发版的开发仓。写完 skill-devkit 从故事里消失;升版本、打基线、打 zip、A/B 审核都走那个文件夹自己的文件。
不是业务项目管理,不是常驻升级引擎,不是万能技能合集。
用法见 examples/(初始化 01~05、07;收编 17~20;半套恢复见 25;初始化之后升版本见 08、21~23;记升级需求见 24;写规则 / 打包 / 试用见 10、06、16)。能力落点见 README 清单。
工作区
初始化:打开空的那个文件夹(或本包半套落盘,见恢复节)。收编:打开已有技能、尚无本包规范的那个文件夹。本包装在用户级技能目录(探测见 references/03-skill-roots.md;Grok 常见为 ~/.grok/skills/)。禁止把业务项目的 ai/ 当 Skill 根。禁止在普通非空目录当空仓初始化。
路由
用户一句话里已给出的字段,不要再问。半套 / 已规范判定见 references/00-core.md(E 先于 C/D)。
| 用户信号 | 工作区 | 加载 |
|---|---|---|
初始化 / 开发一个 skill / 新建 / 创建 / 从零 / 脚手架 / 骨架 / init / scaffold / bootstrap / /skill-devkit / /init-skill / /new-skill |
空(或仅 .git / .DS_Store / Thumbs.db) |
references/01-init.md |
| 同上 | 半套初始化(C) | references/01-init.md 恢复节 |
| 同上 | 已规范(E) | references/01-init.md §2(停止) |
| 同上 | 已有 SKILL.md、无种子痕迹 |
references/01-init.md §2(停止,指路收编) |
| 同上 | 非空且无 SKILL.md、非半套 |
references/01-init.md §2(停止,换空文件夹) |
收编 / 纳入基线 / 改造现有 skill / adopt / retrofit / /skill-devkit adopt |
有 SKILL.md、无痕迹、无 governance/ |
references/02-adopt.md |
| 同上 | 半套收编(D) | references/02-adopt.md 恢复节 |
| 同上 | 空 | 停止,指路初始化 |
| 同上 | 已规范(E) | 停止,已规范 |
| 同上 | 非空无 SKILL.md |
停止 |
| 升级 / 你是 Agent A / 你是 Agent B / 写 AP / 打基线 / 发版 / 执行升级 | 任意 | 停止。已初始化或收编的仓读它自己的 governance/rules/skill-governance.md 与 upgrade-dual-agent.md |
硬闸见 references/00-core.md。初始化正文 01-init.md。收编正文 02-adopt.md。探测 03-skill-roots.md。同义开口 04-triggers.md。
硬闸
- 初始化只允许 (a) 空文件夹或空 git 仓,或 (b) 本包半套落盘(C)。其它非空不写盘、不问「能不能在这里初始化」。
- 收编只允许:根上有
SKILL.md,不是本包自己,不在已探测的助手安装目录,版本多源冲突未决不写盘。已规范(E)停止。来源不明的governance/(无种子痕迹)停止。半套收编(D)走恢复,不改正文。 - 用户确认问答清单之前禁止写盘。
- 新空仓版本固定
0.1.0。收编保留已有版本(无则 0.1.0),不因收编升版。 - 已规范仓禁止再初始化、禁止再收编。收编禁止改写技能正文与已有规则文件。
- 禁止生成业务项目管理文件。禁止把
.git建在governance/里。 - 禁止给本包或目标仓做用户自动升级。禁止默装进任何已探测的助手技能目录。
- 初始化或收编结束后不要继续用本包识别该仓。
版本
本包:见 VERSION。目标仓初始化为 0.1.0,收编沿用已有版本,之后由那个仓的 VERSION + governance/ 管。