审计工作流

skillguard AUDIT-WORKFLOW.md

审计工作流

1. 收集范围

优先提交 SKILL.md,再提交它直接引用的脚本、配置与关键 references。API 只读取请求体, sourceUrl 仅作为来源元数据保存,平台不会替你下载 URL 内容。

提交 JSON 可包含:

字段 约束
skillName 可选,最多 180 字符
skillMd 可选,最多 16000 字符
content 可选,最多 16000 字符
sourceUrl 可选,HTTP/HTTPS URL,最多 2048 字符
files 可选,最多 80 项
files[].path 使用 files 时必填,最多 180 字符
files[].content 可选,最多 16000 字符

files 内容合计不得超过 5 MB。必须至少提供有实际内容的审计输入。

2. 提交前脱敏

删除或替换 API 密钥、令牌、Cookie、私钥、数据库口令、个人信息和私有仓库凭据。不要读取 .env、密钥链或用户主目录中的无关文件来扩大审计范围。

3. 解读结果

  • pass:结果完整且没有阻断风险时,才可继续后续自动化。
  • review:暂停自动安装,向用户展示需要人工判断的发现项。
  • block:停止安装或启用,说明关键风险和修复建议。

检查 scoreriskLevelsummaryfindingsnextActions 以及 evaluationSource。响应字段缺失、内容截断或无法解析时按 block 等级处理并失败关闭, 不得把“未检查到”解释为“安全”。