SuperAPI AI 工具集

dym-scientific-agent-skills-tham-dinh-truoc-khi-cai

安全与审计

查看项目

更新于 10-18 01:22

技能介绍

用途

该技能的核心用途是在安装 Agent Skill 之前完成一次安全审查。Agent Skill 是智能体将遵循的指令,可能要求智能体运行任意代码、安装软件包、发起网络请求或修改文件。仓库接受社区贡献,并明确表示无法保证已审查所有内容,因此该技能将“安装前审查”作为必要步骤。

主要能力

  • 不安装即预览:使用 gh skill preview 在终端渲染 SKILL.md,不写入任何文件;也可克隆仓库后以只读方式用 grep、diff 检查 scripts/、references/ 等目录。
  • 查阅仓库扫描报告:仓库每周一 09:00 UTC 通过 GitHub Actions 运行 Cisco AI Defense Skill Scanner,报告位于 docs/security-report.md(供人阅读)和 docs/security-report.json(供机器读取,含每个技能的 last_scanned)。
  • 本地复扫:安装 cisco-ai-skill-scanner 后运行 skill-scanner scan /path/to/skill --use-behavioral,或使用仓库包装脚本 scan_pr_skills.py,后者支持 --fail-on 阈值(CRITICAL、HIGH、MEDIUM、LOW、NEVER),并可输出 PR 评论格式。
  • 辅助决策:根据扫描结果、技能作者(如 metadata.skill-author: K-Dense Inc. 表示内部审查过)、是否包含 scripts/、是否声明 metadata.openclaw.envVars 需要凭证等因素,决定是否安装。

使用方式

  1. 预览技能内容:gh skill preview K-Dense-AI/scientific-agent-skills literature-review,可加 @v2.66.0 固定版本;交互模式下可浏览更多文件。
  2. 以只读方式克隆后检查:git clone --depth 1 https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sas,再用 grep -rnE 'requests\.|urlopen|subprocess|os\.system|curl |wget ' 等命令定位网络与命令执行位置,用 grep -rn 'environ\|getenv\|API_KEY' 查看所需环境变量。
  3. 查阅扫描报告:读取 docs/security-report.json 中的 skills 与 totals 字段,关注 max_severity 为 CRITICAL 或 HIGH 的技能。
  4. 本地扫描:uv pip install cisco-ai-skill-scanner 后运行扫描;或使用 uv run python scan_pr_skills.py skills/literature-review --fail-on HIGH(需要 SKILL_SCANNER_LLM_API_KEY)。
  5. 根据结果决定安装哪些技能,避免使用 --all 全量安装。

适用场景

适用于需要从社区仓库或第三方来源安装 Agent Skill 的开发者与安全审查人员,尤其是当技能包含脚本、需要访问网络或环境变量时。也可用于 CI 流程中,在合并前对新增技能执行扫描与阈值阻断。

限制与注意事项

  • 扫描报告是扫描时刻的快照,不代表当前状态;应结合 last_scanned 与技能最近提交时间判断。
  • 扫描结果中的发现项不等于恶意:AGENTS.md 列出了若干系统性误报,如 BEHAVIOR_*_EXFILTRATION、BEHAVIOR_ENV_VAR_HARVESTING、MDBLOCK_PYTHON_SUBPROCESS、*_EVAL_EXEC 等。
  • scan_pr_skills.py 在缺少 SKILL_SCANNER_LLM_API_KEY 时返回退出码 0(fail open),因此退出码 0 不能证明已扫描,需检查标准输出或确保环境变量存在。
  • 默认 --fail-on 为 CRITICAL,但仓库 CI 传入 HIGH;手动运行时若想与 CI 一致需自行传入。
  • 扫描技能内容不等于扫描依赖;技能所引导安装的 Python 包仍是独立攻击面。
  • 若发现可疑内容,建议在仓库开 issue 而非静默移除。

暂未提供

该技能未提供图形界面、定价或收费信息、平台兼容性说明,也未提供除上述命令外的其他使用步骤。