SuperAPI AI 工具集

skillpack-harvest

部署与运维

查看项目

更新于 10-16 03:47

技能介绍

用途:把宿主仓库(如 OpenClaw 分支)中已验证的技能上提回 gbrain 技能包,使其他客户端可 scaffold。与 gbrain skillpack scaffold 互为逆操作:scaffold 从 gbrain 下发到宿主,harvest 从宿主上提到 gbrain,成为可复用参考。

主要能力:产出三类文件——skills/<slug>/SKILL.md 及同目录文件(如 routing-eval.jsonl);宿主 SKILL.md frontmatter 声明 sources 时按镜像路径生成配对源文件(如 src/commands/<slug>.ts);更新 openclaw.plugin.json,将新 slug 按序加入 skills: 数组,且不移除 id、configSchema、contracts 等原生字段。支持 --dry-run 预览、--json 机器可读输出、--overwrite-local 覆盖同名、--no-lint 跳过隐私检查。

业务可用判定:宿主技能成熟(生产使用、近期 routing-eval 用例通过);第三阶段编辑泛化已清除所有分支特定引用;干跑已预览文件集;真实 harvest 成功且无隐私检查命中;bun test test/skills-conformance.test.ts 通过;用户已审阅并明确批准提交。

工作流:阶段一询问 slug、宿主仓库根路径、是否带配对源文件;阶段二运行 gbrain skillpack harvest <slug> --from <host-repo-root> --dry-run 预览;阶段三人工泛化清单(个人名、真实实体、邮箱、内部频道、工单号、分支约定、triggers、routing-eval 用例、代码注释统一替换或删除);阶段四运行真实 harvest,默认启用路径限制与符号链接拒绝,隐私检查命中即回滚并非零退出,结果可为 harvested、lint_failed、slug_collision;阶段五用 bun test test/skills-conformance.test.ts、gbrain skillpack check --strict、gbrain skillpack list 验证并审阅 git diff 后提交;阶段六可选在 CHANGELOG.md 的“Skills added”中记录。

限制:harvest 是复制而非移动,宿主技能保留;不自动清洗名称,编辑环节需人工;不发布到 npm 或远程包,仅写入 gbrain 工作树;不支持 --all 批量。反模式包括跳过干跑、仅依赖 linter、无理由使用 --no-lint、上提仍在变动的技能、移动而非复制、批量上提。阶段四、阶段五相关命令与判定条件应保持原样。