Skill Github Import

Skill GitHub Import

当 Butler 已经确认某个 GitHub 仓库目录里存在可复用 skill，需要把它正式导入到本地 skill 池时，使用本 skill。

本 skill 的边界

• 只负责从 GitHub 公共仓库 下载指定目录到本地。
• 默认导入到 ./butler_main/platform/skills/pool/imported/。
• 不自动把导入结果加入默认 collection；是否暴露给 chat/codex/orchestrator，需要另行审阅并登记到 collections/registry.json。
• 不替代安全审阅。导入后仍需人工检查 SKILL.md、脚本、副作用与许可证。

入口脚本

• ./butler_main/platform/skills/pool/ops/skill-github-import/scripts/import_github_skill.py

标准用法

& '.venv\Scripts\python.exe' `
  'butler_main/platform/skills/pool/ops/skill-github-import/scripts/import_github_skill.py' `
  --repo 'Narwhal-Lab/MagicSkills' `
  --path 'skill_template/c_2_ast' `
  --ref 'main'

执行步骤

1. 先确认目标目录确实是一个 skill 目录，至少应包含 SKILL.md。
2. 运行导入脚本，把目录下载到 ./butler_main/platform/skills/pool/imported/<skill-name>/。
3. 检查导入目录中的：
   • SKILL.md
   • scripts/
   • references/ / assets/ / 其他依赖文件
4. 查看脚本自动生成的：
   • UPSTREAM_IMPORT.json
   • IMPORT_REPORT.md
5. 如果要给运行时暴露，再去更新 ./butler_main/platform/skills/collections/registry.json。

参数

• --repo：owner/repo
• --path：仓库内 skill 目录路径
• --ref：分支/tag/commit，默认 main
• --dest-root：目标根目录，默认 ./butler_main/platform/skills/pool/imported
• --name：可选，指定导入后的目录名
• --replace：若目标目录已存在则覆盖

输出

• 导入后的 skill 目录
• UPSTREAM_IMPORT.json
• IMPORT_REPORT.md

注意事项

• 如果目标目录里没有 SKILL.md，本 skill 应直接失败，不要假装导入成功。
• 导入只是“拿到本地真源候选”，不是“已经可对外暴露”。
• 对脚本型 skill，后续至少还要补一次验证或沙箱试跑。