# 🛡️ 守卫技能 ### 代理技能安装的安全门 []() []() []() **安装前扫描。每次。** 何时使用 • 扫描命令 • 解释结果 • 门标志 • 评分 ** ** ## 🚨 何时使用 **在安装任何技能之前始终运行guardskills。**这包括： * 通过 `skills add` (skills.sh) 安装 * 通过“playbooks add Skill”安装 * 通过 `openskills install` 安装 * 通过`skillkit install`安装 * 从本地路径运行任何技能 * 从 ClawHub 安装 **切勿在未先扫描的情况下直接运行技能安装程序。** ** ** ## 📥 安装 Guardskills 可作为 npm 包使用： npx Guardskills --帮助或者全局安装： npm install -g 防护技能 ** ** ## 🔍 扫描命令 ### 1\. GitHub 技能（最常见）扫描 GitHub 托管的技能而不安装： npx Guardskills 添加所有者/存储库 --skill <技能名称> --dry-run 还接受完整的 URL： npx Guardskills 添加 https://github.com/owner/repo --skill <技能名称> --dry-run ### 2\.当地技能扫描磁盘上的技能文件夹： npx Guardskills scan-local <技能文件夹路径> 如果路径包含多个技能： npx Guardskills scan-local <技能根路径> --skill <技能文件夹名称> ### 3\.爪轮技能按标识符或完整 URL 扫描： npx Guardskills scan-clawhub 所有者/skill-slug npx Guardskills scan-clawhub https://clawhub.ai/owner/skill-slug ### 4\.受保护的安装（扫描通过后）如果扫描结果可接受，请运行受保护的安装： #技能.sh npx Guardskills add Owner/repo --skill <技能名称> # 或者使用提供者前缀 npx Guardskills 技能添加所有者/repo --skill <技能名称> npx Guardskills 剧本添加技能所有者/存储库 --skill <技能名称> npx Guardskills openskills install Owner/repo <技能名称> npx Guardskills 技能包安装所有者/存储库<技能名称> Guardskills 将首先扫描，然后仅在门允许的情况下将其移交给底层安装程序。 ** ** ## 🎯 解释结果 Guardskills 产生五个风险决策之一：决定|意义|行动 ---|---|--- **安全** |未检测到已知的高风险模式 | ✅ 继续 **警告** |发现一些中等风险模式| ⚠️要求用户确认 **不安全** |检测到高风险模式 | 🚫 除非用户明确使用 `--force` 覆盖，否则阻止 **关键** |硬阻止 — 凭证泄露、RCE、破坏性操作或权限升级 | 🛑 始终阻止 **无法验证** |无法全面分析内容 | 🚫 除非用户明确允许“--allow-unverabilible”，否则阻止 ### 如何回应每个决定安全 → 继续安装。警告 → 告诉用户发现了什么。询问他们是否想继续。不安全 → 告诉用户该技能是高风险的。除非他们明确表示要覆盖，否则请勿安装。关键 → 告诉用户技能被阻止。不要安装。没有可用的覆盖。无法验证 → 告诉用户内容无法完全扫描。除非他们明确允许，否则请勿安装。 ** ** ## 🏁 门旗旗帜|目的 ---|--- `--试运行` |仅扫描 + 决策，无安装交接 `--ci` |确定性门模式，无需安装切换，适用于 CI 管道 `--json` |机器可读的 JSON 输出 `--是` |接受警告而不提示 `--force` |接受 UNSAFE（极其谨慎使用） `--允许无法验证` |接受无法验证的结果 `--严格` |使用更严格的评分阈值 ** ** ## 🔧 旋转变压器控制微调 GitHub API 行为： npx Guardskills 添加所有者/存储库 --技能名称 \ --github-timeout-ms 15000 \ --github-重试 2 \ --github-retry-base-ms 300 \ --最大文件字节 250000 \ --最大辅助文件 40 \ --最大文件总数 120 ** ** ## 📊 评分逻辑 Guardskills 使用两层模型： ### 第 1 层：硬块护栏当**所有**为真时，发现结果会触发自动硬阻止： * 严重性为“严重” * 信心“高” * 类型为“CREDENTIAL_EXFIL”、“DESTRUCTIVE_OP”、“REMOTE_CODE_EXEC”或“PRIV_ESCALATION” ### 第 2 层：加权风险评分 (0–100) 风险评分 = 钳位( sum(基点×置信度乘数) + 链奖励 − 信任信用， 0, 100 ） **严重性基点：** CRITICAL=50、HIGH=25、MEDIUM=12、LOW=5、INFO=0 **置信乘数：** 高=1.0，中=0.7，低=0.4 **标准阈值：** 分数 |决定 ---|--- 0–29 |安全 30–59 | 30–59警告 60–79 |不安全 80–100 |关键 **严格的阈值**（`--strict`）：分数 |决定 ---|--- 0–19 |安全 20-39 | 20-39警告 40–59 | 40–59不安全 60–100 |关键 ** ** ## 📋 退出代码代码|含义 ---|--- `0` |允许/成功 `10` |警告未确认 `20` |被阻止（不安全、严重或无法验证且无法覆盖） `30` |运行时/内部错误 ** ** ## 🔄 推荐工作流程每次安装技能时请遵循此工作流程： 1. **首先扫描** — 为源类型选择正确的命令： # GitHub npx Guardskills 添加所有者/存储库 --skill <名称> --dry-run # 本地 npx Guardskills 扫描本地 <路径> # 爪轮 npx Guardskills scan-clawhub 所有者/slug 2. **阅读决定** — 检查其是否为“安全”、“警告”、“不安全”、“严重”或“无法验证”。 3. **根据决定采取行动：** * 安全 → 继续受保护的安装 * 警告 → 通知用户，要求确认 * 不安全/严重 → 阻止并解释发现结果 * 无法验证 → 阻止并解释 4. **通过guardskills安装**（切勿直接安装）： npx Guardskills 添加所有者/存储库 --skill <名称> ** ** ## ⚙️ 配置 Guardskills 支持存储库级策略的配置文件（`guardskills.config.json`）： { “默认”：{ “严格”：假， “ci”：假， “json”：假， “是”：假， “干运行”：假， “力”：假， “允许无法验证”：假 }, “解析器”：{ “githubTimeoutMs”：15000， “github重试”：2， “githubRetryBaseMs”：300， “最大文件字节数”：250000， “最大辅助文件数”：40， “最大文件总数”：120 }, “政策”：{ “allowForce”：正确， “allowUnverabilibleOverride”：真， “允许的所有者”：[]， “被阻止的所有者”：[]， “允许的Repos”：[]， “blockedRepos”：[] } } ** ** ## 📚 参考文献 * [npm 上的guardskills]() * [GitHub 上的guardskills]() * [扫描仪规则矩阵]() ** ** ## 📄 许可证 MIT 许可证 — 有关详细信息，请参阅 [LICENSE]()。 ** ** **🛡️ 安装前扫描。每次。** **[GitHub 上的guardskills]() · [npm 上的guardskills]()**

守卫技能

包含技能