⚖ 校验关卡 · 安全校验

核心原则

安全即道基，破则劫败
安全决策必须可追溯
Critical/High 问题必须修复后才能交付

自动扫描

运行安全扫描脚本（跨平台）：

bash
# 在 skill 目录下运行
node scripts/security_scanner.js <扫描路径>
node scripts/security_scanner.js <扫描路径> -v           # 详细模式
node scripts/security_scanner.js <扫描路径> --json       # JSON 输出
node scripts/security_scanner.js <扫描路径> --exclude vendor  # 排除目录

检测范围

自动检测的漏洞类型

| 类别 | 检测项 | 严重度 | |------|--------|--------| | 注入 | SQL 注入、命令注入、代码注入 | 🔴 Critical | | 敏感信息 | 硬编码密钥、AWS Key、私钥 | 🔴 Critical | | XSS | innerHTML、dangerouslySetInnerHTML | 🟠 High | | 反序列化 | pickle.loads、yaml.load | 🟠 High | | 路径遍历 | 未验证的文件路径操作 | 🟠 High | | SSRF | 未验证的 URL 请求 | 🟠 High | | XXE | 不安全的 XML 解析 | 🟠 High | | 弱加密 | MD5、SHA1 用于安全场景 | 🟡 Medium | | 不安全随机 | random 模块用于安全场景 | 🟡 Medium | | 调试代码 | console.log、print、debugger | 🔵 Low |

文档层面检查

安全相关代码必须在 DESIGN.md 中记录：

• ] 威胁模型 — 防御哪些攻击
• ] 安全决策 — 为何选择此方案
• ] 安全边界 — 信任边界在哪里
• ] 已知风险 — 接受了哪些风险

危险模式速查

Python

python
# 🔴 危险 - 触犯道基
eval(), exec(), os.system()
subprocess(..., shell=True)
pickle.loads(), yaml.load()
cursor.execute(f"SELECT * FROM t WHERE id = {id}")

# ✅ 安全替代 - 道基稳固
ast.literal_eval()
subprocess([...], shell=False)
yaml.safe_load()
cursor.execute("SELECT * FROM t WHERE id = %s", (id,))

JavaScript

javascript
// 🔴 危险 - 触犯道基
eval(), innerHTML, document.write()
new Function(userInput)

// ✅ 安全替代 - 道基稳固
JSON.parse(), textContent
模板引擎自动转义

Go

go
// 🔴 危险 - 触犯道基
exec.Command("sh", "-c", userInput)
template.HTML(userInput)

// ✅ 安全替代 - 道基稳固
exec.Command("cmd", args...)
html/template 自动转义

校验流程

1. 运行 security_scanner.js 自动扫描
2. 分析扫描结果，按严重度排序
3. 检查安全决策是否有文档记录
4. 输出安全校验报告
5. Critical/High 问题必须修复后才能交付

自动触发时机

| 场景 | 触发条件 | |------|----------| | 新建模块 | 模块创建完成时 | | 安全相关变更 | 涉及认证、授权、加密、输入处理 | | 攻防任务 | 红队/蓝队任务完成时 | | 重构完成 | 重构任务完成时 | | 提交前 | 代码提交前检查 |

校验报告格式

## 安全校验报告

✓ 通过 | ✗ 未通过

- 🔴 Critical: N
- 🟠 High: N
- 🟡 Medium: N
- 🔵 Low: N

### 发现问题

| 文件 | 行号 | 类型 | 严重度 | 描述 |
|------|------|------|--------|------|
| ... | ... | ... | ... | ... |

### 结论

可交付 / 需修复后交付