法律合理性审查

技能文档

---
name: majiayu000-legal-sanity-review
title: 法律合理性审查
category: 法律合规
description: 在提交代码、发起 PR、代码移植或交叉审查之前，对工作区执行法律合规扫描，阻止客户项目名称、专有工具引用等法律敏感内容进入审查或发布环节。当用户要求「法律审查」「合规扫描」「法务预检」「提交前检查敏感信息」时触发。
---

# 法律合理性审查工作流

本技能是一个**强制性预检门禁**：确保客户项目名称、专有工具引用或其他法律敏感内容不会进入交叉审查阶段或 Pull Request。若法律扫描未通过，审查流程不得继续。

## 技能工作流

整体流程：完成任务并提交变更 → 执行法律合理性扫描（强制预检门禁）→ 通过则继续审查，未通过则修复后重扫。

### 步骤1：执行扫描

在提交变更后、进入交叉审查前运行扫描脚本：

```bash
# 仅扫描本次变更（diff 范围）
./scripts/legal/legal-sanity-scan.sh --diff-only

# 全仓库扫描
./scripts/legal/legal-sanity-scan.sh --repo=<项目名>

# 扫描全部子模块
./scripts/legal/legal-sanity-scan.sh --all
```

也可将扫描挂入 PR 创建前的钩子：

```bash
./scripts/legal/legal-sanity-scan.sh --diff-only || (echo "Legal sanity FAILED" && exit 1)
```

### 步骤2：判定扫描结果

| 结果 | 退出码 | 处理 |
|------|--------|------|
| PASS（通过） | 0 | 继续进入交叉审查 |
| BLOCK（阻断） | 1 | 修复违规项后重新扫描 |
| SCAN_ERROR（扫描异常） | 2 | 检查脚本与配置后重试 |

### 步骤3：处置违规项

扫描发现阻断级违规时：

1. **停止** —— 不得进入交叉审查或创建 PR
2. **报告** —— 逐条列出违规项（含文件:行号与命中模式）
3. **修复** —— 将客户/专有引用替换为通用等价表述
4. **重扫** —— 确认所有违规项已清除
5. **继续** —— 通过后进入后续审查流程

### 步骤4：配置屏蔽清单

扫描所用的匹配模式由屏蔽清单（deny list）控制：

- **全局**：工作区根目录的 `.legal-deny-list.yaml`
- **按项目**：`<子模块>/.legal-deny-list.yaml`

可在清单中追加组织自定义的敏感模式。

## 集成点

- **交叉审查预检**：在第一轮交叉审查迭代之前运行本扫描
- **PR 前置钩子**：集成到 PR 管理流程的 hooks 中（见步骤1 示例）
- **手动调用**：随时可对全仓库或指定子模块执行扫描

每当提交 AI 生成或移植的代码时，都应先运行本流程，确保进入审查前满足法律合规要求。

使用说明

# 法律合理性审查

在提交代码、创建 PR 或交叉审查之前，对工作区执行法律合规扫描，拦截客户项目名称、专有工具引用等法律敏感内容。

## 使用

对本次变更做预检：

```bash
./scripts/legal/legal-sanity-scan.sh --diff-only
```

全仓库扫描：

```bash
./scripts/legal/legal-sanity-scan.sh --repo=<项目名>
```

退出码：0 通过、1 存在违规（需修复后重扫）、2 扫描异常（检查脚本与配置）。

## 工作原理

扫描脚本按屏蔽清单（`.legal-deny-list.yaml`，支持全局与按子模块配置）定义的敏感模式逐项匹配代码与文档。发现阻断级违规时停止审查流程，列出违规位置与命中模式，修复后重新扫描直至通过。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。