SuperAPI AI 工具集

ln-760-security-setup

部署与运维

查看项目

更新于 10-15 13:37

技能介绍

用途 该技能是一个 L2 领域协调器,属于 7XX Bootstrap 类别。其目的是为项目搭建安全扫描基础设施,协调密钥扫描与依赖漏洞审计,把两类扫描结果汇总为统一报告,并生成配套的安全配置文件。适用时机:项目引导阶段(由 ln-700-project-bootstrap 调用)、手动发起安全审计、CI/CD 流水线初始化。

主要能力

  1. 协调两个工作单元:ln-761 密钥扫描器,用于检测硬编码密钥;ln-625 依赖复用审计器,以 vulnerabilities_only 模式运行,仅做 CVE 漏洞扫描,跳过过时/未使用检查。
  2. 汇总两者发现,按严重程度分组(Critical 优先),计算整体安全评分并做风险评估:Critical 项标记为需立即处理,High 项建议 48 小时内修复,Medium/Low 加入待办。
  3. 生成安全产物:SECURITY.md、pre-commit 钩子配置、CI 工作流,并在 .gitignore 中补充密钥相关模式。

工作流程 第一阶段预检:检测项目类型与主生态(Node.js、.NET、Python、Go 等),检查是否已有安全配置(.gitleaks.toml、SECURITY.md);检查 gitleaks/trufflehog 和各生态审计工具是否可用,缺失工具只记录警告而不失败;加载已有配置并标记为保留或更新。 第二阶段委派扫描:通过 Agent 工具并行调用 ln-761 和 ln-625(后者必须传 mode=vulnerabilities_only),分别获得发现列表、严重程度摘要、修复建议,以及漏洞列表、CVSS 评分和修复建议。 第三阶段聚合报告:合并发现、按严重程度分组、计算安全评分、按上述规则做风险评估,并生成包含扫描文件数、发现的密钥数与漏洞数、整体 pass/warn/fail 状态的摘要。 第四阶段生成产物:根据模板创建或更新 SECURITY.md(已存在则更新并保留自定义章节);若缺少 .pre-commit-config.yaml 则按模板创建,存在但无 gitleaks 钩子则建议添加;若缺少 .github/workflows/security.yml 则按模板生成,并包含对应生态的审计任务;更新 .gitignore,确保包含 .env、.env.、!.env.example、.pem、*.key 等模式并保留已有条目。

使用方式 所有工作单元委派必须使用 Agent 工具并设置 subagent_type 为 general-purpose,以实现上下文隔离。宿主技能调用通过 Skill(skill: "...", args: "...") 执行。文档给出的提示模板示例为:Agent(description: "Secret scanning via ln-761", prompt: "Execute security scanner.\n\nStep 1: Invoke worker:\n Skill(skill: \"ln-761-secret-scanner\")\n\nCONTEXT:\nProject: {projectPath}", subagent_type: "general-purpose") 与 Agent(description: "Dependency vulnerability scan via ln-625", prompt: "Execute vulnerability scanner.\n\nStep 1: Invoke worker:\n Skill(skill: \"ln-625-dependency-reuse-auditor\")\n\nCONTEXT:\nProject: {projectPath}\nMode: vulnerabilities_only (only CVE scan, skip outdated/unused checks)", subagent_type: "general-purpose")。反模式包括:直接调用 Skill 工具而不经 Agent 包装、任何绕过子代理上下文隔离的执行、调用 ln-625 时不传 mode 参数(会触发完整审计)。

适用场景 项目引导启动、手动安全审计、CI/CD 流水线初始化,尤其是需要一次性建立密钥扫描与依赖漏洞监控基础设施的项目。

限制与关键规则 必须始终向 ln-625 传 mode=vulnerabilities_only,完整审计模式不适用于引导场景;必须保留现有配置,.gitleaks.toml、SECURITY.md、.pre-commit-config.yaml 存在时应更新而非覆盖;工具缺失不应导致失败,只记录警告并继续使用可用扫描器;Critical 发现会阻断完成流程,返回父协调器前需标记为立即处理。参考文件包括 references/templates/security_md_template.md、references/templates/precommit_config_template.yaml、references/templates/ci_workflow_template.yaml。可选的元分析需在用户要求时加载 references/meta_analysis_protocol.md,并在所有阶段完成后按协议格式输出。版本为 3.0.0,最后更新于 2026-02-05。