SuperAPI AI 工具集

mapping-suite

通用与其它

查看项目

更新于 10-16 01:37

技能介绍

用途:mapping-suite 用于协调一组原本独立运行的映射、审计与文档技能(如 architectural-analysis、release-analysis、wiring-audit、doc-claim-validator、doc-completeness-audit 等),共享同一分析范围与前置架构分析产物,最终把多个技能的独立输出汇总为一个导航 HTML,便于发布工程师入职、on-call 轮值准备和知识传递。

主要能力:提供两种 v1 配方。release-driver onboarding 面向驱动其他系统发布的工具,分析单位是工具执行的操作,通常运行 release-analysis 加 doc-claim-validator,再合并 HTML;deployed-system onboarding 面向被部署系统,通常先运行 architectural-analysis,再叠加 release-analysis,可选 wiring-audit,最后合并 HTML。也支持用户自定义技能序列。

使用方式:Phase 0 一次性解析范围与前置架构分析(用户提供路径、搜索常见位置或询问),结果写入 docs/<suite-date>-suite/suite-scope.md;Phase 1 选择配方;Phase 2 生成运行计划并写入 suite.yaml,所有步骤初始 status: pending;Phase 3 逐步展示推荐调用、等待用户手动调用、记录输出路径并更新清单;Phase 4 运行 bash scripts/compile-combined.sh docs/<suite-date>-suite/ 生成导航 HTML,可用 --banner <path> 添加横幅;Phase 5 根据各技能发现推荐后续技能,但不自动执行。

限制:该技能不会自动调用同级技能,每个步骤都停在批准关卡;不用于仅需单个技能的场景;不会修改同级技能输出,只做链接;不自行生成分析发现;不应嵌套自身。部分同级技能尚未读取 suite-scope.md,此时需在调用提示中重复传入范围。具体收费、价格与运行环境暂未提供。