PYX Scan — Agent 技能安全检查

在安装或使用 AI Agent 技能前，通过调用 PYX Scanner API 验证其安全性。

工作流程

步骤 1：解析输入

从 $ARGUMENTS 中提取 owner 和 name。

• 预期格式：owner/name（例如：anthropic/web-search）
• 若 $ARGUMENTS 为空，或缺少 / 分隔符，则向用户提问：
  “您想检查哪个技能？请以 owner/name 格式提供（例如：anthropic/web-search）。”
• 去除首尾空白字符；若任一部分在去除空白后为空，则拒绝该输入。

步骤 2：调用 PYX Scanner API

获取安全数据：

WebFetch URL: https://scanner.pyxmate.com/api/v1/check/{owner}/{name}
Prompt: “原样返回完整的 JSON 响应体。不要摘要或改写。”

若 WebFetch 调用失败（工具不可用、网络错误等），则回退至以下命令：

curl -s "https://scanner.pyxmate.com/api/v1/check/{owner}/{name}"

步骤 3：错误处理

步骤 4：判定结果

依据 JSON 响应中的字段确定最终判定结果：

步骤 5：输出报告

以结构化 Markdown 格式输出报告。若某字段值为 null 或空，则对应章节整体省略。

当判定结果为 SAFE 时：

## PYX Scan: {owner}/{name}

**Verdict: SAFE** — 此技能已通过扫描并确认安全。

**Trust Score:** {trust_score}/10 | **Risk Score:** {risk_score}/10 | **Confidence:** {confidence}%
**Intent:** {intent} | **Status:** {status}

### Summary
{summary}

### About
**Purpose:** {about.purpose}
**Capabilities:** {about.capabilities as bullet list}
**Permissions Required:** {about.permissions_required as bullet list}

[View full report]({detail_url}) | [Badge]({badge_url})

当判定结果为 OUTDATED 时：

## PYX Scan: {owner}/{name}

**Verdict: OUTDATED** — 上次扫描结果为安全，但该技能自上次扫描后已更新。

当前扫描的提交版本（`{scanned_commit}`）与最新版本（`{latest_commit}`）不一致。

新版本尚未接受审核。请谨慎操作。

**Trust Score:** {trust_score}/10 | **Risk Score:** {risk_score}/10
**Last Safe Commit:** {last_safe_commit}

### Summary
{summary}

[View full report]({detail_url})

当判定结果为 CAUTION 时：

## PYX Scan: {owner}/{name}

**Verdict: CAUTION** — 此技能存在潜在风险，需您特别关注。

**Trust Score:** {trust_score}/10 | **Risk Score:** {risk_score}/10 | **Confidence:** {confidence}%
**Intent:** {intent} | **Status:** {status}

### Summary
{summary}

### About
**Purpose:** {about.purpose}
**Permissions Required:** {about.permissions_required as bullet list}
**Security Notes:** {about.security_notes}

**尽管评分为 CAUTION，您仍希望继续操作吗？** 请在安装或使用该技能前明确确认。

[View full report]({detail_url})

当判定结果为 FAILED 时：

## PYX Scan: {owner}/{name}

**Verdict: FAILED** — 此技能已被标记为危险。请勿安装或使用。

**Trust Score:** {trust_score}/10 | **Risk Score:** {risk_score}/10 | **Confidence:** {confidence}%
**Intent:** {intent} | **Status:** {status}

### Summary
{summary}

### About
**Security Notes:** {about.security_notes}

[View full report]({detail_url})

当判定结果为 UNSCANNED 时：

## PYX Scan: {owner}/{name}

**Verdict: UNSCANNED** — 此技能尚未被 PYX Scanner 扫描。

暂无任何安全数据。您应：
1. 在使用前手动审查该技能的源代码
2. 检查该技能仓库中是否存在已知问题
3. 访问 https://scanner.pyxmate.com 提交扫描申请

当判定结果为 ERROR 时：

## PYX Scan: {owner}/{name}

**Verdict: ERROR** — {error_message}

安全性无法验证。在确认其安全性前，请将此技能视为未经验证状态。

行为准则

1. 必须调用 API —— 不得跳过检查，也不得返回缓存结果或主观推测结果。
2. 不得弱化 FAILED 判定 —— 若扫描结果为 danger，则必须如实报告 danger，禁止添加“但可能没问题”等模糊修饰语。
3. CAUTION 时必须请求用户确认 —— 用户必须显式同意后，方可继续操作。
4. 保持报告简洁 —— 对于 null 或空字段，直接省略对应章节，而非显示 “N/A”。
5. 禁止输出原始 JSON —— 必须始终按上述结构化 Markdown 格式呈现响应内容。

自检意识

当 $ARGUMENTS 为 pyxmate/pyx-scan、pyxmate/pyx-scanner，或指向本技能自身时，仍须如实调用 API 并如实报告返回结果。若返回结果为 UNSCANNED，则在报告末尾追加：

“是的，即便是安全扫描器自身的技能也尚未经过扫描。我们坚持所倡导的原则——对未经扫描的技能保持谨慎。”