# code-review

Adopt this skill: https://proskills.md/skills/other/zhuang-he-openclaw-toolkit-skills-code-review

Page: https://proskills.md/skills/other/zhuang-he-openclaw-toolkit-skills-code-review
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/code-review/SKILL.md
size: 4271
upstream: https://github.com/zhuang-he/openclaw-toolkit/blob/main/skills/code-review/SKILL.md

````text
---
name: code-review
description: >
  代码质量审查和安全审计，提供可执行的改进建议。
  触发词：代码审查、code review、审查代码、检查代码、代码质量、安全审计、
  代码安全、代码分析、找 bug、安全漏洞、代码优化建议、review 一下、
  帮我看看代码、检查一下这段代码
---

# Code Review Skill

name: code-review

## Task
代码质量审查和安全审计，提供可执行的改进建议。

## Review Checklist

### 1. 安全问题 (Security) - 最高优先级
- [ ] SQL 注入风险
- [ ] XSS 跨站脚本
- [ ] CSRF 跨站请求伪造
- [ ] 认证/授权漏洞
- [ ] 敏感数据泄露（密码、密钥、PII）
- [ ] 不安全的反序列化
- [ ] 路径遍历漏洞
- [ ] 命令注入风险

### 2. 代码质量 (Code Quality)
- [ ] 命名规范（变量、函数、类）
- [ ] 函数长度和复杂度
- [ ] 代码重复
- [ ] 注释质量和必要性
- [ ] 代码格式一致性

### 3. 性能问题 (Performance)
- [ ] 低效循环和查询
- [ ] 缺失缓存机制
- [ ] 内存泄漏风险
- [ ] 不必要的计算
- [ ] 数据库查询优化

### 4. 可维护性 (Maintainability)
- [ ] 模块化和职责分离
- [ ] 依赖管理
- [ ] 配置外部化
- [ ] 错误处理一致性
- [ ] 日志记录

### 5. 测试覆盖 (Testing)
- [ ] 单元测试存在性
- [ ] 边界条件测试
- [ ] 错误场景测试
- [ ] 集成测试

## Workflow

### Phase 1: 理解代码
1. 读取目标文件和相关上下文
2. 理解代码功能和设计意图
3. 识别关键逻辑路径

### Phase 2: 逐层审查
1. 安全扫描（优先）
2. 代码质量分析
3. 性能热点识别
4. 可维护性评估

### Phase 3: 生成报告
1. 问题分级（Blocker/High/Medium/Low）
2. 提供具体修复代码
3. 给出优先级建议

### Phase 4: 验证建议
1. 确保修复建议可执行
2. 验证不破坏现有功能
3. 提供测试建议

## Output Format

```markdown
# 代码审查报告

## 审查概览
- 文件：[文件路径]
- 行数：[X 行]
- 语言：[语言]
- 审查时间：[时间]

## 问题汇总
| 级别 | 数量 | 说明 |
|------|------|------|
| 🔴 Blocker | X | 必须立即修复 |
| 🟠 High | X | 应尽快修复 |
| 🟡 Medium | X | 建议修复 |
| 🟢 Low | X | 可选优化 |

## 详细问题

### 🔴 [问题标题] - Blocker
**位置**: `文件路径：行号`

**问题描述**:
[详细描述]

**风险**:
[安全/性能/稳定性风险]

**修复建议**:
```[语言]
// 修复后代码
```

**参考**:
- [相关文档/标准链接]

---

### 🟠 [问题标题] - High
...

## 总体评分
- 安全性：⭐⭐⭐⭐☆ (4/5)
- 代码质量：⭐⭐⭐☆☆ (3/5)
- 性能：⭐⭐⭐⭐☆ (4/5)
- 可维护性：⭐⭐⭐☆☆ (3/5)

## 优先行动项
1. [ ] 立即修复 Blocker 问题
2. [ ] 本周内修复 High 问题
3. [ ] 下次迭代处理 Medium 问题

## 正面评价
- [代码亮点 1]
- [代码亮点 2]
```

## Issue Severity Definitions

| 级别 | 定义 | 响应时间 |
|------|------|----------|
| **Blocker** 🔴 | 安全漏洞、严重 bug、数据丢失风险 | 立即修复 |
| **High** 🟠 | 功能缺陷、性能问题、严重代码异味 | 24-48 小时 |
| **Medium** 🟡 | 代码质量、可维护性问题 | 下次迭代 |
| **Low** 🟢 | 风格问题、优化建议 | 有时间时 |

## Rules

1. **安全第一**: 安全问题永远是最高优先级
2. **建设性反馈**: 指出问题的同时提供解决方案
3. **具体定位**: 精确到文件：行号
4. **可执行建议**: 修复代码必须可直接使用
5. **平衡批评**: 也要指出代码亮点
6. **上下文感知**: 考虑项目规模和阶段
7. **避免过度工程**: 建议要适合项目实际需求

## Tools Used

- `read` - 读取代码文件
- `execute_command` - 运行 linter/测试（如 eslint、pylint）
- `write_to_file` - 保存审查报告
- `task` - 复杂项目可启动子代理专项审查

## Language Support

优先支持：
- JavaScript/TypeScript
- Python
- Go
- Java
- Rust
- Shell/Bash

其他语言可审查通用问题（安全、结构、注释等）。

## Notes

- 大型项目建议分模块审查
- 可配合 linter 工具使用（eslint, pylint 等）
- 敏感代码审查注意保密
````

## File: README.md
upstream: https://github.com/zhuang-he/openclaw-toolkit/blob/main/README.md

````text
# OpenClaw Toolkit

<div align="center">

🚀 AI 助手最佳实践 · 开箱即用的 OpenClaw 增强工具包

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![ClawHub](https://img.shields.io/badge/ClawHub-published-green?logo=rocket)](https://clawhub.ai/plugins/openclaw-toolkit)
[![GitHub stars](https://img.shields.io/github/stars/zhuang-HE/openclaw-toolkit?style=social)](https://github.com/zhuang-HE/openclaw-toolkit/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/zhuang-HE/openclaw-toolkit?style=social)](https://github.com/zhuang-HE/openclaw-toolkit/network/members)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

**16 个预定义组件 · Commands / Agents / Skills 三层解耦 · 一键安装**

[快速开始](#-快速开始) · [核心组件](#-核心组件) · [使用演示](#-使用演示) · [安装方式](#-安装) · [贡献指南](CONTRIBUTING.md)

</div>

---

## 🎯 项目简介

OpenClaw Toolkit 将业界领先的 AI 助手最佳实践打包成开箱即用的组件，集成到 OpenClaw 框架。

### 核心特性

| 特性 | 说明 |
|------|------|
| 🧩 **三层解耦架构** | Commands → Agents → Skills，职责清晰，易于扩展 |
| 🚀 **16 个预定义组件** | 覆盖研究、审查、文档、工作流、记忆、外部集成、知识图谱 |
| 🌍 **多源研究** | 聚合搜索引擎 + 微信公众号 + 通用搜索，结果更全面 |
| 🔍 **安全代码审查** | 自动识别安全漏洞、代码质量问题和优化建议 |
| 🧠 **记忆系统** | 自动整理和压缩工作记忆，保持长期知识可用 |
| 🔗 **外部服务集成** | GitHub、Docker、数据库等外部工具无缝连接 |
| 📊 **知识图谱** | Graphify 代码知识图谱，71.5x Token 节省 |

---

## 📂 项目结构

```
openclaw-toolkit/
├── commands/               # 6 个快捷命令（用户入口）
│   ├── research.md        # /research  深度研究
│   ├── review.md          # /review    代码审查
│   ├── docs.md            # /docs      文档生成
│   ├── git.md             # /git       Git 工作流
│   ├── memory.md          # /memory    记忆管理
│   └── connect.md         # /connect   外部连接
│
├── agents/                 # 3 个专业代理（任务执行）
│   ├── researcher.md      # 研究代理：多源信息搜集分析
│   ├── code-reviewer.md   # 审查代理：代码质量 + 安全审计
│   └── documentation-writer.md  # 文档代理：技术文档编写
│
├── skills/                 # 7 个技能模块（可复用能力）
│   ├── web-research/       # 网络研究
│   ├── code-review/        # 代码审查
│   ├── documentation/       # 文档生成
│   ├── git-workflow/       # Git 工作流
│   ├── memory-consolidation/  # 记忆整理
│   ├── mcp-connector/      # 外部连接
│   └── fusion-workflow-hub/ # 🔥 融合工作流中心
│
└── examples/              # 工作流示例
    └── workflow-examples.md
```

---

## 🖥️ 使用演示

### 安装后，在 OpenClaw 会话中直接调用：

```
你：帮我深度研究一下无人机保险的市场现状
─────────────────────────────────────────────────
[Tool] /research 无人机保险市场 2026

  ✓ 搜索 12 个来源（微信公众号 + 网络搜索）
  ✓ 整理行业报告 3 份、政策文件 2 份
  ✓ 生成结构化分析报告

─────────────────────────────────────────────────

你：review 这段代码有没有安全问题
─────────────────────────────────────────────────
[Tool] /review src/auth.ts

  🔍 扫描中...
  ⚠️ 发现 2 个风险点：
     • SQL 注入风险（第 23 行）
     • 敏感信息明文存储（第 45 行）
  ✅ 代码质量评分：78/100
  💡 优化建议已生成

─────────────────────────────────────────────────

你：帮我生成 API 文档
─────────────────────────────────────────────────
[Tool] /docs src/api/ --type=openapi

  ✓ 分析 12 个端点
  ✓ 生成 OpenAPI 3.0 文档
  ✓ 保存至 docs/api.md
```

### 🔥 Fusion Workflow Hub 使用示例

```
你：帮我分析这个代码库的结构
─────────────────────────────────────────────────
[Tool] fusion-workflow-hub

  ✓ 调用 Graphify 构建知识图谱
  ✓ 读取 GRAPH_REPORT.md 理解架构
  ✓ 使用 query 查询关键模块
  ✓ 生成交互式图谱 graph.html
```

### 命令速查

```bash
/research <主题>        # 深度网络研究
/review <文件或目录>    # 代码审查 + 安全审计
/docs <路径> --type=<类型>  # 文档生成
/git <操作>             # Git 工作流自动化
/memory <操作>          # 记忆整理与压缩
/connect <服务>          # 外部服务连接
```

---

## 🚀 快速开始

### 方式一：通过 ClawHub 安装（推荐）

```bash
# 一键安装（安装整个工具包）
clawhub install zhuang-HE/openclaw-toolkit

# 或者安装单个 skill
clawhub install web-research
clawhub install code-review
clawhub install fusion-workflow-hub
```

### 方式二：手动安装

```bash
# 克隆仓库
git clone https://github.com/zhuang-HE/openclaw-toolkit.git
cd openclaw-toolkit

# Windows
xcopy /E /I skills\* %USERPROFILE%\.workbuddy\skills\

# macOS / Linux
cp -r skills/* ~/.workbuddy/skills/

# 验证
ls ~/.workbuddy/skills/
```

> **提示**：安装到 `~/.workbuddy/skills/` 后，WorkBuddy 会根据 SKILL.md 中的 frontmatter 触发词自动加载对应技能，无需手动选择。

---

## 🧩 核心组件

### Commands（命令层）

| 命令 | 功能 | 底层技能 |
|------|------|---------|
| `/research` | 深度网络研究，多源聚合 | `web-research` |
| `/review` | 代码审查 + 安全审计 | `code-review` |
| `/docs` | 技术文档生成 | `documentation` |
| `/git` | Git 工作流自动化 | `git-workflow` |
| `/memory` | 记忆整理与压缩 | `memory-consolidation` |
| `/connect` | 外部服务连接 | `mcp-connector` |

### Skills（技能层）

| 技能 | 功能 | 复杂度 |
|------|------|--------|
| `web-research` | 聚合微信/网络多源搜索，结构化报告 | ⭐⭐ |
| `code-review` | 质量审查 + 安全扫描 + 优化建议 | ⭐⭐⭐ |
| `documentation` | README / API文档 / 变更日志 | ⭐⭐ |
| `git-workflow` | 智能提交 + 分支管理 + PR 准备 | ⭐⭐ |
| `memory-consolidation` | 日志压缩 + 长期记忆提炼 | ⭐⭐⭐ |
| `mcp-connector` | GitHub / Docker / 数据库 / kubectl | ⭐⭐⭐⭐ |
| `fusion-workflow-hub` | 🔥 Graphify + ECC + OpenClaw 融合工作流 | ⭐⭐⭐⭐ |

---

## 🔥 融合工作流中心 (Fusion Workflow Hub)

整合三大 AI 开发工具的能力，形成完整的智能编码工作流：

| 工具 | 核心能力 | Token 节省 |
|------|----------|------------|
| **Graphify** | 代码知识图谱构建与查询 | 71.5x |
| **ECC** | 68 命令、36 Agent、151 Skill | - |
| **OpenClaw** | 平台集成规则与自动化 | - |

### 工作流一：代码库深度分析

```bash
python -m graphify <目录路径>        # 构建知识图谱
python -m graphify query "<问题>"    # 查询
python -m graphify path "<A>" "<B>" # 路径追踪
```

### 工作流二：功能开发（TDD）

```
use_skill tdd-workflow    # 测试先行
use_skill code-review     # 代码审查
python -m graphify . --update  # 增量更新
```

### 工作流三：持续学习优化

```
use_skill continuous-learning-v2  # 经验积累
use_skill strategic-compact        # 上下文压缩
```

---

## 🛠️ 自定义扩展

### 添加新 Skill

在 `skills/` 下创建目录和 `SKILL.md` 即可：

```
skills/my-awesome-skill/
└── SKILL.md
```

Skill 会被 WorkBuddy 自动发现并根据触发词加载。

### 发布到 ClawHub

```bash
clawhub login --token <your-token>
clawhub package publish . \
  --source-repo zhuang-HE/openclaw-toolkit \
  --source-commit <commit-sha> \
  --name openclaw-toolkit \
  --version 1.0.2 \
  --changelog "Your changelog here"
```

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

- 🐛 报告 Bug → [Issue](https://github.com/zhuang-HE/openclaw-toolkit/issues/new/choose)
- 💡 提出功能建议 → [Discussion](https://github.com/zhuang-HE/openclaw-toolkit/discussions)
- 📖 完善文档或示例

详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

---

## 📄 许可证

MIT License · © 2024-2026 [zhuang-HE](https://github.com/zhuang-HE)

---

## 📬 联系方式

- 🐛 问题反馈：[GitHub Issues](https://github.com/zhuang-HE/openclaw-toolkit/issues)
- 💬 功能讨论：[GitHub Discussions](https://github.com/zhuang-HE/openclaw-toolkit/discussions)
- 📦 ClawHub：[clawhub.ai/plugins/openclaw-toolkit](https://clawhub.ai/plugins/openclaw-toolkit)
- 📖 OpenClaw 文档：[docs.openclaw.ai](https://docs.openclaw.ai)

---

<div align="center">

**Made with ❤️ for the OpenClaw Community**

</div>
````
