Clawhub Gate

SKILL.md

---
name: clawhub-gate
description: |
  ClawHub 发布前安全门禁：本地静态分析 + ClawScan 轮询，确保 skill 通过 VirusTotal + ClawScan 再发布。
  关键词：clawhub publish pre-publish security gate VirusTotal ClawScan shellcheck bandit
triggers:
  - (.*) clawhub (.*) 发布 (.*)
  - (.*) clawhub (.*) sync (.*)
  - (.*) skill (.*) 安全 (.*) 检测 (.*)
  - (.*) 发布 (.*) clawhub (.*) 前 (.*)
  - (.*) clawhub (.*) gate (.*)
required_environment_variables: []
required_commands:
  - shellcheck
  - bandit
  - jq
  - python3
  - clawhub
required_config_paths:
  - ~/.config/clawhub/config.json
---

# ClawHub Pre-Publish Security Gate

`clawhub sync` 前自动执行三项检查，全部通过才放行。

## 流程

```
clawhub_gate.sh
├── 1. 本地静态分析  (即时)
│   ├── shellcheck  →  .sh 文件
│   └── bandit      →  .py 文件
│
└── 2. clawhub sync + ClawScan 轮询  (异步，约 30-90s)
    └── 轮询 clawhub API 直到 scan status != "pending"
        ├── VT=clean + Static=clean + LLM=clean  → 通过
        ├── VT=clean + Static=clean + LLM=suspicious → 警告通过（owner 接受 LLM 情境判断）
        └── VT 或 Static 失败  → 阻断

## 使用方式

在 skill 目录下运行 gate 脚本：

```bash
# 完整 gate：静态分析 + 发布 + ClawScan 轮询
SKILL_DIR=~/.hermes/skills/pg-game-monitor bash clawhub_gate.sh

# 仅本地静态分析（快速检查，不需要网络）
SKILL_DIR=~/.hermes/skills/pg-game-monitor bash clawhub_gate.sh --local-only
```

**前置条件**：已安装 `shellcheck`、`bandit`、`jq`、Python 3、`clawhub` CLI（已登录）。

**脚本行为**：
- 读取 `~/.config/clawhub/config.json` 获取 token（用于轮询 ClawScan API）
- 调用 `clawhub sync` **发布** skill（会创建/更新 ClawHub 版本）
- 若不需发布，先跑 `--local-only` 确认静态分析通过，再手动 `clawhub sync`

## 退出码

| 码 | 含义 |
|----|------|
| 0 | 全部通过 |
| 1 | 静态分析失败或 ClawScan flagged |
| 2 | ClawScan 超时（pending > 120s） |
| 3 | 未找到 skill 目录或权限错误 |

## 检查详情

### 静态分析

| 工具 | 扫描范围 | 严重级别 |
|------|---------|---------|
| shellcheck | `*.sh` | warning + error |
| bandit | `*.py` | medium + high + hidden |

- **阈值**：ERROR 数量 = 0；WARNING 数量 ≤ 10（可配置 `WARN_LIMIT`）
- **误报忽略**：`SC2154`（未使用变量，常见于条件分支）、`SC2086`（引号去除，常见于 `grep -v`）

### ClawScan 轮询

- **轮询间隔**：15s
- **最大等待**：120s（8 次）
- **状态判断**：
  - `clean` → 通过
  - `suspicious` → 失败，输出警告
  - `malicious` → 失败，阻断
  - `pending` → 继续轮询
  - `error` → 失败

## 依赖

```bash
pip install --break-system-packages bandit
apt install -y shellcheck
```

## 参考

- ClawScan 修复指南：`clawhub` skill → `references/clawscan-remediation.md`