SuperAPI AI 工具集

diagnose-sandbox-report

通用与其它

查看项目

更新于 10-16 07:24

技能介绍

用途:诊断 Nx 沙箱违规。当 Nx 任务读取未声明为 inputs 的文件或写入未声明为 outputs 的文件时,用该技能分析沙箱报告,判断访问原因并给出修复方向。

主要能力:接收沙箱报告 JSON 路径、URL、任务 ID 加 CIPE URL 或内联违规数据;支持按单文件、逗号列表、glob 或目录前缀过滤;先运行确定性脚本生成紧凑摘要与完整明细文件,再分析进程命令、配置引用链、依赖任务输出与插件推断,最后按缺失输入、缺失输出、工具配置错误、潜在沙箱缺口等类别输出结构化诊断。

使用方式:第一步必须运行上下文收集脚本,不要直接读取报告 JSON,也不要对原始报告使用 Read、cat、head、python3 或 jq:

npx tsx ${CLAUDE_SKILL_DIR}/scripts/gather-sandbox-context.ts <report.json or URL> [--filter <pattern>] [--workspace <path>]

脚本输出摘要与明细文件,明细文件仅可用 jq 查询。确认违规时使用:

npx nx show target inputs <project>:<target> --check <violated-read-files> npx nx show target outputs <project>:<target> --check <violated-write-files>

适用场景:Nx 工作区中任务出现沙箱违规、需要判断是补充输入/输出声明还是修正工具配置、涉及插件推断目标、子进程访问、配置引用链或依赖任务输出 glob 过窄等情况。

限制:默认假设意外访问属于缺失声明,需先追踪完整因果链再分类;脚本失败时应报告错误并停止,不得手动解析作为回退;修复前需先确认推断插件;结论需经 --check 验证。具体收费、价格与平台信息暂未提供。