skill-manager

Skill Manager

只管理当前实例的 {{OCTOP_SKILLS}}/。当前实例工作区固定为 {{OCTOP_WORKSPACE}}；上传文件通常位于其中的 inbound/。系统文件（skills、内置 skills、会话等）在 {{OCTOP_SKILLS}} 所在目录。不要用 pwd、$HOME、~/.octop-harness/workspace、记忆文件或搜索结果重新猜测工作区。不要改其他实例、全局 Skill 目录或 {{OCTOP_BUILTIN_SKILLS}}/。

操作入口

使用内置脚本完成检查、下载、安全解包、安装、列出和删除：

python "{{OCTOP_BUILTIN_SKILLS}}/skill-manager/scripts/manage_skills.py" <command>

# 列出已安装技能
... list

# 检查来源，不写入已安装 skills 目录
... inspect "<file-directory-url-or-skillhub:slug>"

# 安装；仓库或压缩包内的多个 Skill 可一次安装
... install "<source>" [--subpath "path/in/repo"] [--name "slug"]

# 仅在用户明确同意替换后覆盖
... install "<source>" --force

# SkillHub 搜索；结果可用 skillhub:<slug> 检查或安装
... skillhub-search "<query>" --limit 10

# 仅在用户明确同意删除后执行；实际移动到 skills/.trash/
... remove "<slug>" --yes

# 从回收站恢复
... restore "<trash-name>"

来源处理

1. 现成 Skill、目录或 ZIP/TAR：先 inspect；检查通过且用户已要求安装时执行 install。
2. Git/GitHub URL：可直接处理仓库、GitHub tree 子目录和指向 SKILL.md 的 blob URL。复杂仓库使用 git+<url> 和 --subpath。
3. SkillHub 页面 URL：https://skillhub.cn/skills/<namespace>/<slug> 可直接传给 inspect 或 install；脚本会解析 namespace 和 slug。不要自行安装/升级 CLI，不要直接运行 skillhub install。
4. 普通 HTTP(S) URL：脚本处理直接文件和压缩包。若 URL 是其他介绍网页，先用现有网页工具读取并找到公开仓库、下载地址或 SKILL.md，再交给脚本。不得绕过登录、付费墙或访问控制。
5. SkillHub 搜索：用户只描述能力时，先搜索并给出 1–3 个候选的 slug、名称、用途和来源，让用户选择；用户已点名具体 Skill 时，可直接检查并安装。
6. 任意非 Skill 文件：普通资料不会因复制而自动成为 Skill。先读取和理解材料，再使用内置 skill-creator 工作流，将可复用知识、步骤和必要资源整理为合法 Skill，写入 {{OCTOP_SKILLS}}/<slug>/，然后执行 inspect 校验。

变更规则

• 新安装请求本身即表示同意新增；目标已存在时停止并说明冲突，只有获得明确同意才使用 --force。
• 编辑现有 Skill 前先读取其 SKILL.md 和相关资源，只改该 Skill 目录；修改后重新 inspect。
• 删除前点名目标并取得明确确认。使用 remove --yes，不要直接 rm -rf。需要恢复时使用 restore。
• 安装后报告 slug 和最终路径。新安装、更新或删除的 Skill 通常从下一次新会话开始完整生效。

安全边界

• 脚本限制下载及解包体积、文件数，拒绝路径穿越和符号链接，并通过暂存目录安装。
• 不执行、导入或 source 下载包中的代码。安装表示部署 Skill 内容，不代表第三方代码已通过安全审计。
• 不在输出中回显 URL 凭据；私有来源只使用环境中已有的 Git 或 SkillHub 凭据。
• 若当前实例没有 Shell 执行能力，仍可用文件工具处理简单文本 Skill，但必须说明 URL 下载、安全解包和 SkillHub CLI 无法完成，不能假装成功。