适用于 Openclaw 的 代码复杂度分析器

一款多语言静态分析工具,通过测量圈复杂度、认知复杂度和结构化指标来识别高风险代码。

charlie-morrison
v1.0.1
2026年5月1日
0
926
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install code-complexity-analyzer

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 code-complexity-analyzer。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 代码复杂度分析器?

代码复杂度分析器是一个强大的实用程序,旨在通过量化代码测试和维护的难度来维持高工程标准。通过将其集成到您的 Openclaw Skills 库中,开发人员可以自动扫描源代码,查找导致技术债务的深度嵌套、过长函数和复杂的逻辑路径。

作为不带外部依赖的纯 Python 工具构建,它提供了评估 Python、JavaScript、TypeScript 和 Go 文件的有效方法。它通过关注理解代码的感知难度(认知复杂度)和独立执行路径的数量(圈复杂度),帮助团队超越简单的 linting。

代码复杂度分析器 应用场景

  • 通过精确定位高风险函数,识别遗留代码库中的重构候选对象。
  • 设置 CI/CD 质量门禁,防止合并过于复杂的代码。
  • 为拉取请求评审生成 Markdown 格式的自动化复杂度报告。
  • 审计新依赖项或内部模块的可维护性和结构完整性。

代码复杂度分析器 工作原理

  1. 该工具将目标源文件解析为对应语言的抽象语法树 (AST)。
  2. 它遍历树以识别函数定义和逻辑控制结构(如循环和条件语句)。
  3. 它根据结构计算包括圈复杂度 (CC)、认知复杂度 (COG) 和嵌套深度在内的指标。
  4. 它将这些值与可配置的阈值进行比较,以确定风险级别(简单、低、中等或高)。
  5. 最后,它以文本、JSON 或 Markdown 格式输出结果,并根据违规状态返回退出代码。

代码复杂度分析器 配置指南

要开始在您的 Openclaw Skills 中使用此工具,请确保已安装 Python 3。不需要额外的 pip 安装。

# 克隆或定位脚本
# 分析您的源目录
python3 scripts/analyze_complexity.py src/

# 使用自定义阈值运行以实现更严格的 CI 门禁
python3 scripts/analyze_complexity.py src/ --cc 8 --cog 12

代码复杂度分析器 数据架构与分类体系

分析器根据函数级粒度组织其发现。它跟踪每个分析文件的以下分类:

指标 描述 指标内容
CC 圈复杂度 逻辑路径
COG 认知复杂度 可读性评分
Lines 函数长度 垂直规模
Params 参数计数 接口表面
Nesting 最大深度 逻辑缩进

输出结果可以导出为结构化 JSON 对象,以便集成到其他 Openclaw Skills 工作流中。

代码复杂度分析器 高级特性

  • 支持多格式输出 (JSON, Markdown, Text),实现无缝工具集成。
  • 可配置的风险级别映射,用于区分轻微技术债务和关键风险。
  • 自动排除 node_modules 和 pycache 等常见目录。
  • 详细模式可查看所有函数的完全透明度,而不仅仅是违反阈值的函数。
  • 标准化退出代码 (0, 1, 2),便于集成到 shell 脚本和自动化流水线中。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*