skill-installation

npx skills add uvwt/agentdock --skill skill-installation --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Skill Installation 用于把本地或外部 Skill 安全地纳入当前 AgentDock，并验证当前激活版本确实可用。Skill 只提供审查和安装流程；真实读取、校验、配置、安装、命令执行和回滚由工具完成。 ## 何时使用 使用本 Skill 处理： - 安装本地或第三方 Skill； - 审查未知 Skill 的代码、权限和数据行为； - 配置已安装 Skill 的环境变量； - 更新并激活新版本； - 验证 Skill 是否已进入索引并可读取； - 对当前激活版本运行只读状态检查； - 回滚到上一已安装版本。 不要使用本 Skill 创建新 Skill、重写核心设计、替作者决定业务边界，或大范围修改第三方包。需要修改源码、补测试、升级文档或重新设计时，切换到 `skill-authoring`。 完整安全审查规范见 `skill://skill-installation/references/skill-security-review.md`。 ## 核心原则 1. 先审查，后安装；不能把 `skill_package validate` 当作完整安全审计。 2. 来源、摘要、版本、风险和缺失配置必须可追溯。 3. 默认只读检查；写入、删除、上传、权限变化和依赖安装必须显式识别。 4. 不替用户生成、猜测或迁移真实秘密。 5. 环境变量只通过 AgentDock 的 Skill 独立环境管理能力配置。 6. 安装成功不等于可用；必须验证当前激活版本、索引、正文、引用和只读状态。 7. 回滚只切换已安装版本，不删除私有状态，也不覆盖共享环境配置。 ## 标准流程 ### 1. 识别来源 先记录： - 来源类型：本地目录、本地压缩包或 HTTPS 下载地址； - 来源位置和发布者； - 目标 Skill 名称和版本； - 用户期望安装、更新、验证还是回滚； - 是否提供预期 SHA-256 摘要； - 是否为首次接触的第三方包。 远程来源优先要求可信发布页和可验证摘要。URL 认证信息、查询参数和片段不得写入报告或日志。 ### 2. 在安装前获取静态内容 在隔离的临时审查位置查看包，不直接从未知目录运行脚本。至少读取： - 根目录文件清单； - `SKILL.md`； - `references/`； - 所有脚本和测试； - 依赖清单和锁文件； - 包内二进制、压缩包或生成文件； - 隐藏文件； - 符号链接和特殊文件。 只读检查不应加载包内环境文件、不应执行安装钩子，也不应运行未知脚本。 ### 3. 检查结构和 Frontmatter 确认： - 包根目录存在 `SKILL.md`； - Frontmatter 只依赖当前正式字段 `name`、`description`、`version`； - `name` 稳定且与安装目标一致