Menu
深度代码审查工具：分析 Git 变更，评估逻辑、代码规范、安全及需求一致性，支持CodeReview报告。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | code-review |
| description | 深度代码审查工具：分析 Git 变更，评估逻辑、代码规范、安全及需求一致性，支持CodeReview报告。 |
执行超越 lint 的深度分析，识别安全漏洞、并发问题、潜在 Bug、架构设计问题，并生成专业报告。
0.配置 → 1.需求 → 2.代码变更 → 3.Lint → 4.架构分析 → 5.深度审查 → 6.报告 → 7.Todo清单
检查项目根目录 .codereview 配置（参考 assets/.codereview.example）：
exclude_paths: 跳过的文件/目录ignore_categories/ignore_rules: 忽略的审查类别/规则severity: 严格程度（strict/normal/relaxed）根据用户输入类型选择操作：
| 输入类型 | 操作 |
|---|---|
| TAPD URL | 使用 TAPD MCP 获取需求（如不可用则提示） |
| Word 文档 | python3 scripts/parse_word.py <file.docx> |
| Markdown/文本 | read_file 直接读取 |
| 其他 URL | curl -s <URL> | sed 's/<[^>]*>//g' |
| 口头描述 | 记录并确认理解 |
检测编程语言（go.mod/pom.xml/package.json/.sql/.cs/.proto/.lua/.css等）和框架类型（go-zero检查.api文件）。
语言检测规则：
go.mod 文件pom.xml 或 build.gradle 文件requirements.txt 或 setup.py 文件.cpp/.h 文件.sql 文件.cs/.csproj 文件.proto 文件.lua 文件.css 文件# 单个提交
python3 scripts/analyze_git_diff.py --range <commit>~1..<commit>
# 多个提交
python3 scripts/analyze_git_diff.py --range <start>..<end>
# 指定文件
python3 scripts/analyze_git_diff.py --range HEAD~3..HEAD --files file1.go file2.go
# 输出JSON
python3 scripts/analyze_git_diff.py --range HEAD~1..HEAD --output changes.json
触发词："审查本次版本"、"review当前版本"
git describe --tags --abbrev=0 # 获取上个tag
python3 scripts/analyze_git_diff.py --range <tag>..HEAD
使用 read_file/view_code_item 读取，应用 exclude_paths 过滤。
python3 scripts/lint_check.py -l <go|java|cpp|python> [--repo <path>]
执行逻辑：
Makefile 中的 lint: 目标 → 执行 make lint.golangci.yml > skill内置assets/.golangci.yml输出：成功输出"Lint Success"，失败输出错误信息。
生成规格文档 docs/spec-<功能名称>-<日期>.md，包含：
如有需求文档，执行对比分析：✅已实现 / ⚠️部分实现 / ❌缺失
必须加载 references/coding-standards/<语言>/ 下的标准和安全文档：
| 语言 | 文档 |
|---|---|
| Go | standard.md, security.md |
| C++ | standard.md, security.md |
| Java | standard.md, security.md |
| Python | standard.md, security.md |
| SQL | standard.md |
| C# | standard.md |
| ProtoBuf | standard.md |
| Lua | standard.md |
| CSS | standard.md |
注意：SQL、C#、ProtoBuf、Lua、CSS的标准文档需要通过 sync_standards.py 脚本从外部仓库同步。首次使用前请执行：
python3 scripts/sync_standards.py --all
并发安全 [concurrency]：data-race、goroutine-leak、lock-usage、channel-operation
安全性 [security]：sql-injection、command-injection、path-traversal、authentication、authorization、weak-crypto、key-management、input-validation、info-disclosure
潜在Bug [bug]：nil-pointer、loop-closure、slice-modification、integer-overflow、boundary-check
性能 [performance]：memory-allocation、string-concatenation、slice-preallocation、struct-copy
编程规范 [coding-standards]：interface-design、error-wrapping、error-checking、context-propagation、naming-convention
资源管理 [resource-management]：resource-close、context-lifecycle、memory-leak
框架专项 [framework]：如果检测到当前项目是Go项目并且go.mod中引入了github.com/zeromicro/go-zero，则被判断为go-zero项目，参考references/coding-standards/go/go-zero-framework.md对 API定义、logic层、配置文件审查
| 级别 | 说明 | 示例 |
|---|---|---|
| 🛑严重 | 功能缺陷、安全漏洞 | SQL注入、数据竞争 |
| ⚠️重要 | 性能、质量问题 | 资源未关闭、错误处理不当 |
| 💡建议 | 代码风格、最佳实践 | 命名规范、预分配slice |
使用 assets/report-template.md 模板生成报告，保存至 docs/code-review-<功能名称>-<日期>.md。
报告结构：基本信息 → 需求符合性 → 代码质量分析 → 深度审查结果 → 专项评估 → 总结评分
### 🛑 Critical (必须修复)
- [ ] [Security] 修复SQL注入 (file.go:123)
### ⚠️ Major (建议修复)
- [ ] [Performance] 预分配slice (processor.go:78)
### 💡 Minor (可选优化)
- [ ] [Style] 命名规范 (utils.go:234)
高优先级（必审）：安全漏洞、并发问题、业务逻辑、关键bug
中优先级（时间允许）：性能优化、代码组织、测试覆盖、错误处理
低优先级（顺带提及）：命名规范、样式问题、文档完整性
跳过：lint已覆盖的基础问题（未使用变量、格式问题、vet警告）
| 脚本 | 用途 | 命令 |
|---|---|---|
analyze_git_diff.py | Git变更分析 | --range <range> [--files ...] [--output file.json] |
lint_check.py | Lint检查 | -l <go|java|cpp|python> [--repo <path>] |
parse_word.py | Word解析 | <file.docx> |
sync_standards.py | 同步外部标准 | --all [--force] 或 --languages <lang1> <lang2> |
assets/report-template.md - 报告模板assets/.codereview.example - 配置示例assets/.golangci.yml - Go lint默认配置references/coding-standards/ - 各语言审查标准
sync_standards.py 同步）必需：Python 3.8+、Git
按需：tencentlint/golangci-lint(Go)、ruff/flake8(Python)、clang-tidy(C++)、Maven/Gradle(Java)
部分语言的编码标准存储在外部Git仓库中，需要通过 sync_standards.py 脚本同步到本地。
# 首次使用：同步所有外部标准
python3 scripts/sync_standards.py --all
# 同步指定语言
python3 scripts/sync_standards.py --languages sql csharp
# 强制更新已存在的标准
python3 scripts/sync_standards.py --all --force
# 列出所有可用标准
python3 scripts/sync_standards.py --list
.temp_repos/ 目录（已在 .gitignore 中忽略）README.md 文件references/coding-standards/<语言>/standard.mdgit pull 获取最新版本--force 更新以获取最新标准