返回顶部
b

br-risk-analyzer风险分析器

根据需求文档分析风险,分析代码漏洞。analyzes code changes between commits against requirement documents to identify and prioritize risk points.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.0
安全检测
已通过
95
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

br-risk-analyzer

BR 风险分析器技能

概述

本技能分析提交之间针对需求文档的代码变更,以识别并优先处理遵循既定代码审查协议的风险点。

工作流实现

步骤1:输入消化

  • - 从需求中提取:功能目标、非功能需求(性能/安全)、边界条件、禁止行为、依赖系统
  • 识别关键术语作为搜索关键词:实体、状态机、配置项、消息主题、外部接口

步骤2:代码范围定义

  • - 使用语义搜索/grep/glob定位:入口点(控制器/定时器/消费者)、核心服务、持久层、消息处理、配置读取
  • 映射数据流(谁写入/读取:数据库/Redis/消息队列/文件)和控制流(同步/异步/重试模式)

步骤3:需求驱动的代码审查

针对每个需求维度,对照代码进行验证:
验证维度关键问题
正确性分支覆盖、安全默认值、枚举/状态一致性
边界
空值处理、大数据集、超时、重复提交、幂等性 | | 并发 | 锁机制、事务边界、可见性、竞态条件 | | 失败路径 | 异常吞没、回滚能力、重试逻辑、部分失败处理 | | 配置与开关 | 配置缺失时的行为、危险开关组合 | | 安全 | 授权、权限提升、注入漏洞、敏感数据日志记录 | | 依赖 | 外部调用失败、降级策略、熔断、超时 | | 兼容性 | 遗留数据处理、旧API支持、灰度部署与回滚 |

步骤4:风险分类与输出

遵循严格的优先级分级:

P0(必须修复)

  • - 财务/数据错误、安全漏洞、大规模故障、不可逆数据损坏

P1(本轮迭代修复)

  • - 特定条件下的功能错误、严重性能下降、放大故障的监控盲区

P2/P3(可选)

  • - 可维护性问题、边缘用例用户体验问题、低概率异常、样式/注释改进

步骤5:知识持久化

  • - 将分析结果和项目理解存储在resources/project-understanding.md中
  • 更新积累的知识以备未来风险评估
  • 维护需求解释和代码库演进的历史上下文

使用协议

输入要求

在单条消息中提供:
  1. 1. 需求/设计文档摘要(或PRD要点、变更说明、接口契约)
  2. 范围(仓库路径、模块、分支、相关工单/任务编号)
  3. 预期输出(仅风险列表 / 风险加测试用例 / 含优先级和修复建议)

执行保证

  • - 需求优先方法:用需求驱动代码检查,而非随机文件扫描
  • 基于证据:每个风险包含文件路径 + 类/方法 + 行为描述;推测标记为需确认
  • 分层风险分析:接口契约、并发/一致性、异常处理、配置/数据、安全/合规、性能/资源、可观测性、兼容性/回滚
  • 需求对齐:明确归类为需求覆盖/需求未提及但潜在问题/当前范围外

输出模板

结果遵循以下强制结构:

markdown

审查摘要


  • - 需求要点:(1-3句话)
  • 代码范围:(模块/路径列表)
  • 概览:P0 x项 / P1 x项 / P2 x项 / P3 x项

风险清单

P0(必须处理)
编号风险描述位置(文件:类/方法)触发条件/影响建议(可选)
R1............

P1(建议本轮修复)
编号风险描述位置触发条件/影响建议
...............

P2 / P3(酌情处理)

  • - ...

需求覆盖评估

  • - 已覆盖:...
  • 需求未明确覆盖但代码中存在:...
  • 本次审查范围外:...

测试建议(可选)
风险编号测试类型场景预期结果
R1集成测试......

结果保存在{需求名称}-risk-analyzer.md中

快速检查清单集成

审查期间,系统性地验证:

  • - [ ] 所有入口点是否有适当的授权/参数验证(如需要)?
  • [ ] 数据库写入和消息发送顺序是否防止不一致?需要事务或补偿?
  • [ ] 异步线程池/消息队列消费失败是否导致数据丢失或重复?
  • [ ] 配置为空、解析失败或依赖服务超时时行为是否已定义?
  • [ ] 日志是否包含敏感数据(密钥、ID、完整请求体)?
  • [ ] 大文件/批量操作是否可能导致内存溢出或线程池耗尽?
  • [ ] 状态机转换是否正确处理非法状态?
  • [ ] 核心分支是否有单元/契约测试?

测试指导

  • - P0/P1风险:提供具体测试场景,包括前置条件、关键步骤、预期结果
  • 测试分类:指明适合单元测试/集成测试/手动回归测试
  • 测试补充但不替代代码审查:测试建议用于验证高风险发现,而非替代逻辑分析

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 br-risk-analyzer-1775918535 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 br-risk-analyzer-1775918535 技能

通过命令行安装

skillhub install br-risk-analyzer-1775918535

下载

⬇ 下载 br-risk-analyzer v1.0.0(免费)

文件大小: 6 KB | 发布时间: 2026-4-12 09:13

v1.0.0 最新 2026-4-12 09:13
Initial release of br-risk-analyzer skill

- Analyzes code changes between commits against requirement documents to identify and prioritize risks.
- Provides a structured, requirement-driven code review protocol covering correctness, boundaries, concurrency, failure paths, config, security, dependencies, and compatibility.
- Delivers risks categorized by priority (P0–P3) with paths, locations, behaviors, and recommendations.
- Persists analysis results and understanding for future use, maintaining historical project context.
- Offers mandatory markdown output template and checklist integration for systematic coverage.
- Supports test scenario suggestions for identified risks.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部