scar-code-review

功能说明

一套能够从自身漏检中持续学习的代码审查系统。该系统由两个协同工作的层级构成：

1. 清单式审查（Checklist review） —— 基于正则表达式与启发式规则，在以下 4 个维度开展检查：

   • 安全性（Security）：SQL 注入、硬编码密钥、XSS、eval/exec 调用
   • 性能（Performance）：N+1 查询、缺失分页、无限制的 SELECT 操作
   • 正确性（Correctness）：未检查空值、边界偏移（off-by-one）模式、未处理的 Promise
   • 可维护性（Maintainability）：过长函数、深层嵌套、魔法数字

2. Scar 反射弧（Scar reflex arc） —— 针对历史审查漏检项进行模式匹配。当某次审查未能捕获一个最终导致线上事故的缺陷时，将其记录为一条 scar；下次审查时，该反射机制将在 LLM 查看 diff 之前即刻触发。

无外部依赖，仅使用 Python 标准库。支持 Python 3.9 及以上版本。

快速开始

审查单个文件：

python3 scar_code_review.py review path/to/file.py

基于历史 scars 检查 diff：

python3 scar_code_review.py check-diff path/to/changes.diff

记录一次漏检发现：

python3 scar_code_review.py record-miss 
  --what-missed "Missed SQL injection in user input handler" 
  --pattern "execute.*format.*user" 
  --severity critical

文件格式

采用 JSONL 格式，兼容 tetra-scar：

{"id":"rscar_1234","what_missed":"...","pattern":"...","severity":"critical","created_at":"..."}

集成方式

from scar_code_review import review, reflex_check, record_miss, load_review_scars

# 审查一个文件
findings = review("app/views.py")
for f in findings:
    print(f"{f['severity']} [{f['dimension']}] {f['message']} (line {f['line']})")

# 基于历史 scars 检查 diff
scars = load_review_scars()
blocks = reflex_check(diff_text, scars)
for b in blocks:
    print(f"BLOCKED: {b}")

# 在事故后记录一次漏检
record_miss(
    what_missed="Missed unvalidated redirect",
    pattern="redirect.*request\.GET",
    severity="high",
)