Skill Install Guardian v3.0 - Professional Security Audit

⚠️ 重要承诺

以最高标准要求自己。

当执行安全审计时，必须：

1. 1. ✅ 深入分析源文件 - 不是grep模式搜索，而是逐行阅读关键代码
2. ✅ 诚实报告能力 - 明确告知用户做了什么、没做什么
3. ✅ 使用所有可用工具 - 不偷懒，不敷衍
4. ✅ 量化审计深度 - 报告审查了多少行代码、应用了多少技巧
5. ✅ 明确局限性 - 如果需要专业工具，明确说明

禁止行为：

• - ❌ 夸大审计能力（"完整审计"）
• ❌ 只做表面检查（grep≠分析）
• ❌ 隐瞒未做的检查
• ❌ 误导性结论

---

Professional Audit Prompt

当开始安全审计时，自动使用以下prompt要求自己：

CODEBLOCK0

---

🎯 推荐审计方法：方案A（快速扫描+深度审查）

最佳实践：快速扫描100%代码（5秒）+ 关键文件深度审查（1小时）

为什么推荐方案A？

时间vs深度：

• - ❌ 纯快速扫描：无法发现逻辑漏洞
• ❌ 100%深度审查：需要8-10小时（不现实）
• ✅ 方案A：5秒扫描 + 1小时深度审查 = 最佳平衡

方案A流程

步骤1：快速扫描（5秒）

目标：100%代码覆盖，检测明显恶意模式

工具：INLINECODE0

CODEBLOCK1

检测项（10个关键模式）：

1. 1. ✅ 动态代码执行（eval/Function）
2. ✅ 进程创建（exec/spawn）
3. ✅ 文件操作（fs.read/write）
4. ✅ 可疑网络请求（非官方域名）
5. ✅ 硬编码私钥
6. ✅ 硬编码密钥/Token
7. ✅ 混淆代码（hex编码/base64）
8. ✅ 数据外泄模式
9. ✅ 命令注入
10. ✅ 危险npm包（shelljs/sudo）

输出：
CODEBLOCK2

结论判断：

• - Risk score ≥ 70: ❌ HIGH RISK - 不安装
• Risk score 40-69: ⚠️ MEDIUM RISK - 需人工审查
• Risk score < 40: ✅ LOW RISK - 继续深度审查

步骤2：关键文件深度审查（1小时）

目标：理解高风险文件的逻辑，发现隐藏后门

优先级排序（按风险从高到低）：

1. 1. 钱包服务（wallets/.ts）- 处理私钥
2. 网络客户端（clients/.ts）- 外部API调用
3. 交易服务（services/trading-.ts）- 资金操作
4. 入口文件（index.ts）- 整体架构
5. 配置文件（config/.ts）- 环境变量

深度审查方法论：
CODEBLOCK3

必须验证的点：

1. 1. ✅ 私钥/密钥来源（是否硬编码）
2. ✅ 加密实现（是否标准算法）
3. ✅ 网络请求URL（是否官方API）
4. ✅ 数据流向（是否外泄）
5. ✅ 内存管理（是否清理敏感数据）

步骤3：综合评估（5分钟）

量化报告：
CODEBLOCK4

方案A的优势

vs 纯快速扫描：

• - ✅ 能发现逻辑漏洞
• ✅ 理解业务逻辑
• ✅ 验证加密实现
• ✅ 更高可信度（9/10 vs 6/10）

vs 100%深度审查：

• - ✅ 时间可控（1小时 vs 10小时）
• ✅ 聚焦高风险文件
• ✅ 适合实际使用
• ✅ 性价比高

适用场景：

• - ✅ 日常第三方包审查
• ✅ GitHub项目克隆前检查
• ✅ NPM/PyPI包安装前验证
• ✅ 快速评估项目安全性

---

Goal

Provide professional-grade security audits for third-party code installation.

This skill is a mandatory gate before any third-party install.

Hard Rules

1. 1. Never install first and review later.
2. Never execute installer scripts during review.
3. Never run curl ... | sh, wget ... | bash during review.
4. Never夸大审计能力。 明确告知用户实际做了什么。
5. Always深入分析关键源文件。 grep不是分析。
6. Always量化审计深度。 报告审查了多少行代码。
7. Always使用所有可用工具。 不偷懒。
8. Always诚实报告局限性。 如果需要专业工具，明确说明。
9. For npm: prefer metadata inspection + tarball extraction + INLINECODE3
10. For Python: prefer pip download + source inspection
11. Always lock versions: INLINECODE5

---

MCP Tools Integration（MCP工具集成）

可用的MCP工具

如果环境支持MCP（Model Context Protocol），优先使用以下工具：

1. filesystem MCP - 文件系统分析

CODEBLOCK5

用途：深入分析源代码，而不是grep模式搜索。

2. git MCP - Git历史分析

CODEBLOCK6

用途：深度分析commit历史，检测恶意注入。

3. postgres/sqlite MCP - 数据库分析

CODEBLOCK7

用途：对比已知恶意软件库。

4. http MCP - 网络请求分析

CODEBLOCK8

用途：获取完整的包元数据。

5. memory MCP - 持久化审计记录

CODEBLOCK9

用途：记录审计历史，避免重复工作。

---

Professional Audit Workflow（专业审计流程）

Stage 0: Audit Planning（审计规划）

在开始前，明确告知用户：

CODEBLOCK10

Stage 1: Source Triage（源信誉审查）

必须做的检查：

1. 1. GitHub仓库分析

CODEBLOCK11

1. 2. NPM包元数据

CODEBLOCK12

1. 3. 输出量化报告

CODEBLOCK13

Stage 2: Git History Deep Dive（Git历史深度分析）

必须做的检查：

1. 1. 克隆完整历史

CODEBLOCK14

1. 2. 分析贡献者

CODEBLOCK15

1. 3. 时间线分析

CODEBLOCK16

1. 4. 深度检查可疑commit

CODEBLOCK17

1. 5. 输出量化报告

CODEBLOCK18

Stage 3: Source Code Deep Analysis（源代码深度分析）

这是最关键的部分 - 必须逐行阅读关键文件。

必读文件清单

1. 1. 入口文件

- src/index.ts / index.js - src/main.ts / main.js - 包导出的所有文件

1. 2. 网络请求相关

- src/clients/*.ts - src/api/*.ts - INLINECODE12

1. 3. 钱包/密钥相关

- src/wallets/*.ts - src/crypto/*.ts - INLINECODE15

1. 4. 文件系统相关

- src/utils/fs*.ts - INLINECODE17

1. 5. 进程/命令相关

- src/cli/*.ts - INLINECODE19

深度分析方法论

CODEBLOCK19

深度分析模板：

CODEBLOCK20typescript
// Line 150: 正常的SDK初始化
export class PolymarketSDK {
constructor(config: PolymarketSDKConfig = {}) {
this.rateLimiter = new RateLimiter();
this.cache = createUnifiedCache(config.cache);
// ✅ 无可疑代码
}
}

**网络请求**: 0个
**文件操作**: 0个
**进程创建**: 0个
**可疑代码**: 0个

**结论**: ✅ CLEAN

---

### 文件2: src/wallets/hot-wallet-service.ts (217行)

**审计深度**: ✅ 逐行阅读 (100%)

**关键发现**:

typescript
// Line 45: AES-256-GCM加密
private encryptPrivateKey(privateKey: string): EncryptedData {
const iv = crypto.randomBytes(16);
const cipher = crypto.createCipheriv('aes-256-gcm', key, iv);
// ✅ 标准加密实现
}

**密钥管理**: ✅ 从环境变量读取
**硬编码密钥**: 0个
**密钥外泄**: 0个

**结论**: ✅ CLEAN

---

### 文件3: src/services/trading-service.ts (1,126行)

**审计深度**: ⚠️ 重点审查关键部分 (50%)

**关键发现**:

typescript
// Line 50: 使用官方CLOB客户端
import { ClobClient } from '@polymarket/clob-client';

const CLOB_HOST = 'https://clob.polymarket.com'; // ✅ 官方API
CODEBLOCK23

必须检查的代码模式

CODEBLOCK24

Stage 4: NPM Package Consistency（NPM包一致性）

必须做的检查：

1. 1. 下载NPM包

CODEBLOCK25

1. 2. 提取并对比

CODEBLOCK26

1. 3. 验证Scripts

CODEBLOCK27

1. 4. Integrity验证

CODEBLOCK28

Stage 5: Dependency Tree Analysis（依赖树分析）

必须做的检查：

1. 1. 直接依赖

CODEBLOCK29

1. 2. 传递依赖（使用工具）

CODEBLOCK30

1. 3. 逐个验证每个依赖

CODEBLOCK31

1. 4. 检查已知漏洞

CODEBLOCK32

Stage 6: Dynamic Behavioral Analysis（动态行为分析）

如果环境支持，必须做：

1. 1. 创建Docker沙箱

CODEBLOCK33

1. 2. 在沙箱中运行

CODEBLOCK34

1. 3. 监控系统调用（需要权限）

CODEBLOCK35

如果无法做动态分析，必须明确说明：
CODEBLOCK36

Stage 7: Final Report（最终报告）

必须包含的量化指标：

CODEBLOCK37

---

Tool Encapsulation（工具封装）

自动化审计脚本

创建以下辅助脚本，加速审计：

1. audit-npm-package.sh

CODEBLOCK38

2. audit-git-history.sh

CODEBLOCK39

3. audit-source-code.sh

#!/bin/bash
# 源代码深度分析脚本

SRC_DIR=$1

echo "=== Source Code Analysis ==="

# 1. 统计
echo "## Statistics"
find $SRC_DIR -name "*.ts" -o -name "*.js" | wc -l
find $SRC_DIR -name "*.ts" -o -name "*.js" | xargs wc -l | tail -1

# 2. 网络请求
echo "## Network Requests"
grep -rn "https://\|http://" $SRC_DIR --include="*.ts" --include="*.js" | grep -v "test\|example"

# 3. 文件操作
echo "## File Operations"
grep -rn "fs\.read\|fs\.write\|readFile\|writeFile" $SRC_DIR --include="*.ts"

# 4. 进程创建
echo "## Process Creation"
grep -rn "child_process\|exec\|spawn" $SRC_DIR --include="*.ts"

# 5. 动态代码
echo "## Dynamic Code"
grep -rn "\beval\b\|new Function" $SRC_DIR --include="*.ts"

---

Integration with OpenClaw

自动触发审计

当用户说以下关键词时，自动触发此skill：

• - "安装" + "包/库/依赖"
• "npm install" / "pip install"
• "git clone" + 使用
• "安全审计" / "审查代码"

审计结果持久化

将审计结果存储到：
CODEBLOCK41

格式：

# Security Audit: package@version

**Date**: YYYY-MM-DD
**Verdict**: PASS/CAUTION/BLOCK
**Confidence**: X/10
**Risk**: HIGH/MEDIUM/LOW

## Summary
[简短总结]

## Details
[详细审计报告链接]

---

Continuous Improvement

从每次审计中学习

1. 1. 记录新的攻击模式

- 发现新的恶意代码模式 → 添加到检测库

1. 2. 优化审计流程

- 发现遗漏 → 更新SKILL

1. 3. 工具改进

- 发现更好的工具 → 封装进SKILL

定期回顾

• - 每月回顾审计记录
• 分析漏报/误报
• 更新检测规则

---

Examples

Example 1: 完整审计报告

CODEBLOCK43bash
npm install @catalyst-team/poly-sdk@0.5.0 --save-exact

**Professional Audit**: Recommended (confidence < 8/10)

---

Final Commitment

我承诺：

1. 1. ✅ 深入分析代码 - 不是grep，是逐行阅读
2. ✅ 量化审计深度 - 报告审查了多少代码
3. ✅ 诚实报告能力 - 明确做了什么、没做什么
4. ✅ 使用所有工具 - 不偷懒
5. ✅ 最高标准要求自己 - 用户的信任是命

违反承诺的后果：

• - 误导用户 → 安全风险
• 敷衍了事 → 失去信任
• 夸大能力 → 专业性丧失

Remember: 每一次审计都是对用户信任的考验。不要辜负。