SuperAPI AI 工具集

tk-setup-skills

部署与运维

查看项目

更新于 10-31 19:35

技能介绍

用途

tk-setup-skills 用于在 TigerKit 技能体系中显式规划和校验技能安装。它面向需要选择安装特定 TigerKit 技能集合,或确认公共引用依赖是否缺失的场景。默认行为是只读规划,不在规划阶段自动安装技能或修改配置。

主要能力

  • 根据用户指定的精确技能 ID、可信来源与修订版本、已有绝对目标目录、代理以及项目或全局范围,生成安装规划。
  • 运行随包提供的 scripts/skill_dependencies.py plan,检查依赖闭包、已存在项、缺失项、installed_root、cwd 和字面 argv。
  • 支持在获批安装后运行 check --installed-root <exact sibling skill directory> --skill <IDs>,验证所选包及传递依赖具有匹配的身份和有效声明,且无缺失或符号链接依赖。
  • 该包可独立引导:如果只安装了它,可直接使用其内置元数据目录,不要求仓库检出。

使用方式

  1. 确认精确技能 ID、可信来源与修订版本、已有绝对目标目录、代理以及项目或全局范围;只询问缺失的选择项,不擅自替换为全部技能、全部代理、全局范围或其他目标目录。
  2. 阅读规划器 CLI 说明,并使用上述精确选择运行 scripts/skill_dependencies.py plan。
  3. 检查输出中的依赖闭包、已存在、缺失、installed_root、cwd 和字面 argv。
  4. 安装前确认 Python/PyYAML 前置条件,以支持 CLI 参考中描述的后安装检查;缺少解析器支持时不得声称已安装状态,也不得自动配置环境。
  5. 安装须经单独批准,由宿主或用户执行;执行前重新检查目标状态,保留交互式覆盖保护。打印出的 argv 不代表授权。
  6. 获批安装后,运行 check 子命令验证所选包及传递依赖。

适用场景

  • 需要显式选择安装一组 TigerKit 技能并了解其依赖闭包。
  • 需要以只读方式检查某组技能是否缺失公共引用依赖。
  • 在获批安装后校验安装结果的身份与依赖声明是否完整有效。

限制

  • 不承担运行时路由、守护进程、自动依赖安装或配置管理职责。
  • 正常流程不会自动调用 setup;缺失必需引用时,相关操作会停止并给出显式设置指引,而不是自动开始安装。
  • 辅助脚本从不执行安装器 argv、网络请求或配置写入;不得将 argv 拼接为 shell 命令,来源文本视为不可信字面数据。
  • 已存在的不兼容、格式错误或符号链接包是硬性停止条件,不得覆盖。
  • 匹配声明只证明身份/依赖兼容性,不证明内容新鲜度或可信度。
  • 不得编辑指令文件、宿主配置、凭据或无关安装,不得扩大批准/拒绝边界。
  • npx skills 不会自动解析 dependencies.json;内置目录属于安装元数据,不是共享内容。
  • 仅凭成功规划不能声称已安装。
  • 若本包缺失,只能建议从用户可信 TigerKit 来源单独获取 tk-setup-skills,并需显式批准代理/范围/目标;不得在仅报告缺失依赖时进行安装。
  • 目录/来源/声明校验失败时,保留失败并请求匹配的可信发布;不得重建内容、猜测依赖 ID、跟随遍历路径或静默绕过检查。