核心功能: 本技能提供化流程等能力。
核心功能: 本技能提供时使用、、工作流优化时使用、处理、工作流优化时使用、化配置和灵活的参数设置等能力。
GoPlus安全扫描
GoPlus AgentGuard安全扫描,支持定时巡逻、漏洞发现、Webhook通知与结果检查.
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | GoPlus安全扫描处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
专业版增值服务
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| GoPlus安全扫描tGuard安全扫描 | 不支持 | 支持 |
| 深度漏洞扫描与CVE关联 | 不支持 | 支持 |
| 安全基线合规审计 | 不支持 | 支持 |
| 批量资产风险评分 | 不支持 | 支持 |
| 威胁情报实时订阅与告警 | 不支持 | 支持 |
运行环境
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖项
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
需要配置对应API Key,详见上文环境配置章节
可用性分类
- 分类: MD+EXEC()
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
能力矩阵
安全扫描(Security Scan)
执行一次性安全扫描,检测代码中的安全漏洞:
- 代码扫描:扫描Go源代码中的安全问题(SQL注入、命令注入、路径遍历等)
- 依赖检查:检查项目依赖中的已知漏洞(CVE)
- 配置审计:检查安全配置项(硬编码密钥、不安全默认值等)
- 扫描范围:支持指定目录、文件或整个项目
- 扫描结果:按严重程度分类(Critical / High / Medium / Low / Info)
定时巡逻(Schedule Patrol)
配置定时安全巡逻,实现持续安全监控:
- 定时执行:按cron表达式定期执行安全扫描
- 巡逻模式:持续监控代码变更,发现新漏洞立即告警
- 增量扫描:仅扫描变更的文件,提高效率
- 巡逻状态:启动、停止、查看巡逻状态
- 巡逻间隔:支持每日、每周、自定义间隔
漏洞发现详情(Findings Detail)
查看每个安全发现(finding)的详细信息:
- 漏洞描述:漏洞类型、描述与影响范围
- 文件路径:漏洞所在的文件路径与行号
- 代码片段:展示存在问题的代码片段
- 修复建议:提供具体的修复方案与代码示例
- 严重程度:Critical / High / Medium / Low / Info 分级
- 状态管理:Open(未处理)、Fixed(已修复)、Ignored(已忽略)
Chat ID / Webhook通知
通过Chat ID或Webhook发送安全通知:
- Chat ID通知:将扫描结果发送到指定聊天会话
- Webhook通知:通过Webhook推送到Slack、飞书、钉钉等平台
- 通知内容:漏洞摘要、严重程度统计、详细报告链接
- 通知时机:扫描完成、发现Critical/High漏洞、巡逻告警
- 通知配置:可配置通知阈值(如仅通知High以上漏洞)
按文件路径定位漏洞(Finding with File Path)
根据文件路径快速定位相关漏洞:
- 路径过滤:按文件路径筛选安全发现
- 文件级视图:查看指定文件中的所有安全问题
- 目录级视图:查看指定目录下的所有安全问题
- 快速跳转:从通知直接跳转到漏洞代码位置
- 批量处理:按文件路径批量修复或忽略漏洞
检查结果(Check Results)
查看与管理安全扫描结果:
- 结果摘要:漏洞总数、按严重程度分布、修复进度
- 历史趋势:漏洞数量随时间的变化趋势
- 修复追踪:跟踪漏洞从发现到修复的全过程
- 报告导出:导出为JSON、Markdown、HTML格式报告
- 对比分析:对比两次扫描结果,识别新增与已修复的漏洞
健康检查(Health Check)
检查GoPlus AgentGuard服务健康状态:
- 服务状态:检查GoPlus CLI是否正常运行
- 配置验证:验证Webhook URL、Chat ID等配置是否有效
- 连接测试:测试与通知平台的连接是否正常
- 版本检查:检查GoPlus CLI版本是否为最新
安装向导
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
详细的输入输出格式请参考下方章节说明。
操作流程
- 安装GoPlus CLI:`go install 相关技术文档
- 执行健康检查,确认服务正常运行
- 执行一次性安全扫描或配置定时巡逻
- 查看漏洞发现详情,按文件路径定位问题
- 配置Chat ID或Webhook接收安全通知
- 修复漏洞后再次扫描验证
- 检查扫描结果,导出报告
示例展示
示例1:执行安全扫描
用户: 扫描我的Go项目安全漏洞
# ...
Agent: 安全扫描完成:
- 扫描文件: 156个
- 发现漏洞: 7个
- Critical: 1 (SQL注入)
- High: 2 (硬编码密钥、命令注入)
- Medium: 3 (不安全配置)
- Low: 1 (信息泄露)
# ...
Critical漏洞详情:
- 文件: cmd/handler/user.go:45
- 类型: SQL Injection
- 代码: db.Query("SELECT * FROM users WHERE name='" + name + "'")
- 修复: 使用参数化查询 db.Query("SELECT * FROM users WHERE name=?", name)
示例2:配置定时巡逻与通知
用户: 配置每天定时巡逻,发现High以上漏洞通知我的飞书群
# ...
Agent: 定时巡逻已配置:
- 巡逻间隔: 每日 09:00
- 扫描范围: 整个项目
- 通知方式: 飞书Webhook
- 通知阈值: High及以上
- Webhook URL: https://open.feishu.cn/open-apis/bot/v2/hook/未指定
# ...
巡逻状态: 已启动
下次执行: 2026-02-17 09:00
示例3:按文件路径查看漏洞
用户: 查看 cmd/handler/ 目录下的所有安全漏洞
# ...
Agent: cmd/handler/ 目录安全发现:
1. user.go:45 - Critical - SQL Injection
2. user.go:78 - High - Hardcoded Secret
3. admin.go:23 - High - Command Injection
4. admin.go:56 - Medium - Insecure Config
5. auth.go:12 - Medium - Weak Crypto
# ...
建议优先修复Critical和High级别漏洞.
异常应对
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| GoPlus CLI未安装 | 未执行go install | 运行 `go install 相关技术文档 安装 |
| 健康检查失败 | GoPlus服务未运行 | 重启GoPlus服务;对照依赖说明章节逐项验证配置项,确认环境变量已正确设置文件 |
| 扫描超时 | 项目过大或网络问题 | 缩小扫描范围;增加超时时间; |
| Webhook推送失败 | URL无效或网络问题 | 验证Webhook URL; |
| Chat ID无效 | 会话ID错误 | 确认Chat ID正确;检查会话权限 |
| 扫描结果为空 | 无Go源代码或路径错误 | 确认扫描路径包含Go文件;检查路径拼写 |
常见疑问
Q1: 安全扫描覆盖哪些类型的漏洞?
A: 覆盖SQL注入、命令注入、路径遍历、硬编码密钥、不安全加密、不安全配置、依赖CVE等多种安全漏洞类型,按Critical/High/Medium/Low/Info五级分类.
Q2: 定时巡逻和一次性扫描有什么区别?
A: 一次性扫描是手动触发的单次扫描。定时巡逻(Schedule Patrol)按cron表达式定期自动扫描,支持增量扫描(仅扫描变更文件),适合持续安全监控.
Q3: 如何配置Webhook通知?
A: 在Slack/飞书/钉钉等平台创建Bot,获取Webhook URL。配置到GoPlus中,设置通知阈值(如仅通知High以上)。扫描完成或发现高危漏洞时自动推送通知.
Q4: 如何按文件路径查看漏洞?
A: 使用按文件路径定位功能,指定文件或目录路径,系统会筛选出该路径下的所有安全发现,包括文件名、行号、漏洞类型与修复建议.
Q5: 漏洞状态如何管理?
A: 每个漏洞有三种状态:Open(未处理)、Fixed(已修复)、Ignored(已忽略)。修复代码后再次扫描会自动更新状态,也可手动标记为Ignored.
Q6: 如何导出安全报告?
A: 支持导出为JSON、Markdown、HTML三种格式。报告包含漏洞摘要、严重程度分布、详细发现列表与修复建议,适用于安全审计与团队协作.
使用约束
- 需要安装GoPlus CLI,无CLI环境无法执行扫描
- 主要针对Go语言项目,对其他语言支持有限
- 依赖漏洞检查需要网络访问CVE数据库
- 定时巡逻需要GoPlus服务持续运行
- 误报率取决于代码复杂度,需人工复核
- Webhook通知受目标平台API频率限制
创新特色
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 代码安全扫描 | 8小时 | 30分钟 | 7.5小时 | 10% |
| 依赖漏洞检查 | 4小时 | 15分钟 | 3.5小时 | 15% |
| 安全配置审计 | 6小时 | 1小时 | 5小时 | 12% |
| 扫描结果分析 | 4小时 | 1小时 | 3小时 | 8% |
| 漏洞修复建议 | 2小时 | 30分钟 | 1.5小时 | 5% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 扫描速度 | 快速 | 较慢 | 一般 | 快速 |
| 扫描范围 | 宽泛 | 有限 | 有限 | 宽泛 |
| 漏洞识别准确率 | 高 | 低 | 中等 | 高 |
| 定制化程度 | 高 | 低 | 中等 | 高 |
| 易用性 | 高 | 低 | 中等 | 高 |
| 成本 | 低 | 高 | 中等 | 高 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 手动安全扫描效率低 | 人工扫描耗时,效率低下,易出错 | 项目安全风险 | 自动化扫描,提高效率,降低风险 | 时间节约30% |
| 漏洞修复周期长 | 漏洞修复周期长,影响项目进度 | 项目进度 | 提供修复建议,缩短修复周期 | 修复周期缩短20% |
| 安全配置管理复杂 | 安全配置管理复杂,难以维护 | 安全配置维护 | 自动化配置审计,简化管理 | 配置管理效率提升40% |
问题排查手册
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 扫描任务未执行 | 配置错误或网络问题 | 检查配置文件和网络连接 | 修正配置或检查网络 |
| 扫描结果为空 | 扫描范围设置错误 | 检查扫描范围设置 | 修正扫描范围 |
| Webhook通知失败 | Webhook配置错误或服务不可用 | 检查Webhook配置和服务状态 | 修正配置或联系服务提供商 |
| 扫描结果不准确 | 数据源问题或扫描规则错误 | 检查数据源和扫描规则 | 修正数据源或扫描规则 |
| 服务状态异常 | 服务配置错误或服务崩溃 | 检查服务配置和状态 | 修正配置或重启服务 |
安全须知事项
- 确保所有扫描任务在安全的环境下执行,避免敏感信息泄露。
- 定期更新GoPlus AgentGuard,以获取最新的安全漏洞库和扫描规则。
- 在配置Webhook通知时,确保使用安全的URL和认证机制。
- 对于发现的漏洞,及时进行修复或采取适当的缓解措施。
- 定期进行安全审计,确保项目符合安全基线标准。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
核心特点
- 自动化执行: GoPlus Agen
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
主要功能
- 自动化执行: GoPlus Agen
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
异常修复
针对GoPlus安全扫描使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
GoPlus安全扫描通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
依赖说明
运行环境
- Agent 平台: 支持SKILL.md的任意AI Agent
- 操作系统: Windows / macOS / Linux
可用性分类
- 分类: MD(纯Markdown指令,通过自然语言驱动Agent完成操作)
- 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作。
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v1.0.1
- License
- MIT-0
