SuperAPI AI 工具集

simready-foundation-update-feature-adapter

智能体与模型

查看项目

更新于 10-16 02:34

技能介绍

用途:当现有 SimReady 功能适配器不再匹配精确的源/目标 FET_###_<RUNTIME> 功能契约、产生无效 USD、缺少必要变更,或需要支持新的 profile 版本时,使用本技能。

前置准备:编辑前需阅读 AGENTS.md、nv_core/sr_specs/docs/guides/feature_adapters/feature_adapters.md、目标适配器文件、源与目标功能清单、源与目标 profile 版本,以及现有适配器测试或验证报告。

输入:需收集或推断 adapter_path(现有适配器文件)、source_feature(当前支持的输入功能名/清单 id 与整数版本)、target_feature(输出功能名/清单 id 与整数版本)、bug_or_gap(缺失变更、错误元数据、无效输出、非幂等、崩溃或 profile 漂移)、new_feature_versions(若需支持新路径的更新整数版本)、test_assets(展示问题的资产或报告)。

操作要点:比对适配器元数据与实际源/目标清单及 profile 版本,确认功能名使用 FET_###_<RUNTIME> 且版本为精确整数;尽可能复现或检查失败的升级;决定更新现有适配器还是为新精确版本路径新增适配器,当已发布的源/目标版本必须保持旧行为时优先新增路径;窄范围修补转换逻辑,保留无关数据、保持输出确定性、避免源阶段变更、正确保存输出阶段;仅在支持的功能路径变化时更新元数据;更新测试或手动验证说明以覆盖修正路径;若适配器行为影响 profile 升级,更新 profile 迁移说明;确认 profile 转换中每个变更的功能差异仍有直接适配器路径或已记录的阻塞项;在工具可用时依据相关功能/profile 要求验证源到目标行为。

策略:不得在未保留仍已发布的旧升级路径的情况下更改适配器以指向不同功能版本;新功能版本优先新增适配器而非改动旧行为;不得添加可能损坏适配器契约之外资产的宽泛兜底变更逻辑;若必要变更需要用户意图,报告阻塞的适配器路径。

限制:不得静默更改已发布契约,行为变化时应新增版本;不得在未检查验证器、清单、profile、适配器与运行时测试影响的情况下更新文档;不得将变更扩大到所选需求、能力、功能、profile、验证器或适配器之外。

故障排查:若请求的变更改动了已发布契约,应创建新版本并保留旧产物;若文档与机器可读清单不一致,应使 JSON/TOML 与 markdown 一致后重跑聚焦检查;若下游 profile 或适配器影响不明确,应先列出受影响产物再做大范围编辑。

资源:assets/openai.yaml 为读取技能显示提示的客户端保留可选 UI 元数据,工作流不依赖它。

报告格式:adapter_path(更改的适配器)、feature_path(输入输出功能名与整数版本)、change_type(缺陷修复、新版本路径或文档/测试更新)、mutation_summary(变更的 USD 行为)、tests(运行的测试/资产)、profile_followup(更改或需要的 profile 文档/迁移说明)、validation(剩余缺口)。