SuperAPI AI 工具集

assessment

编程与开发

查看项目

更新于 10-16 00:31

技能介绍

用途:对单个 Java、.NET 或 JavaScript/TypeScript 仓库执行完全本地的应用评估,评估过程不调用任何 MCP 工具,App Modernization MCP 服务器不在本技能执行路径内。

主要能力:支持 java-upgrade、cloud-readiness、security 领域;分析覆盖度可选 issue-only 或 full。Java/.NET 通过 AppCAT 运行确定性本地引擎;JavaScript/TypeScript 使用固定版本 npm-check-updates 做本地依赖评估,且 planningSupported 为 false。full 覆盖包含六个事实文档技能:architecture-diagram、dependency-map、api-service-contracts、data-architecture、configuration-inventory、business-workflows。安全批次包含 cve-known-vulnerabilities 及六个 CWE 类别技能,每条 CWE 规则须以 FOUND 或 NOT_FOUND 结束。

使用方式:先 bootstrap 工作区运行时,再 prepare-run 生成任务计划,随后按目录顺序串行执行各批次,通过 record-result 归一化结果,最后生成并验证报告。关键命令如:node <loaded-assessment-skill>/scripts/assess-cli.mjs bootstrap --workspace-path <workspace-path>;prepare-run、ensure-appcat、run-appcat、integrate-appcat、run-ncu、generate-report、generate-normalized-assessment、publish-appcat-report、generate-canonical-report、archive-facts、verify-artifacts 等。verify-artifacts 是唯一完成权威,退出码为零且 artifactValidation 为 passed 才算成功。

适用场景:单仓库本地评估、协调器编排、批处理无头模式。批处理模式只接受完全批准的输入,缺失必需信息即失败,不调用 ask_user。

限制:评估期间不得调用 MCP 工具,不得执行计划外技能,不得修改应用源码或构建清单;子代理文本不作为完成证据;事实与安全任务串行执行,有效并发为 1;JavaScript/TypeScript 不支持自动化 Planning;实现修复不在本技能范围内。