SuperAPI AI 工具集

implementation-strategy

编程与开发

查看项目

更新于 10-16 03:05

技能介绍

用途:为 openai-agents-python SDK 的行为变更或评审确定受支持的改动范围与兼容性边界,避免过度扩展实现。

主要能力:先识别改动面(已发布公共 API、分支内 API、内部辅助、持久化 schema、线协议、CLI/配置/环境变量或仅文档示例);在涉及已发布兼容性时,先从 origin 确定最新发布标签,远端不可用时回退本地标签,并标注本地回退可能过期。命令示例:BASE_TAG="$(.agents/skills/final-release-review/scripts/find_latest_release_tag.sh origin 'v*' 2>/dev/null || git tag -l 'v*' --sort=-v:refname | head -n1)"。编码前记录实现范围契约:必需行为、兼容性要求、有意不支持的情况、受支持的替代方案。优先复用最近的现有实现管线与单一事实来源,只按必需边界添加兼容机制。

使用方式:按核心决策规则选择最小且自洽的改动;反馈改变受支持行为、兼容性、所有权、协议路径、实现形态或测试组合时,重访评审门;交接前运行有效性检查,任一答案为否则修改设计。复杂度重置触发时(同类维度反复组合、需解释宿主语言或第三方协议、窄需求需递归解析或新状态、测试枚举机制且 diff 持续增长),冻结当前修订、按根因分组、写出由发现推导的重置规范并审计后冻结,再按保留/替换/删除映射完整 diff。

适用场景:SDK 公共 API 与持久化状态(如 RunState、会话持久化)的兼容性敏感改动;OpenAI API 或 provider 适配器行为差异;新增公共配置、字典输入支持、可选字段追加、阈值与配额语义等。

限制:资料未提供具体版本号、平台、收费或效果信息;已发布版本复现只证明可达性,不证明受支持,除非有文档、示例、测试或类型标注覆盖。需要确认的情形包括:改动已发布受支持行为、修改持久化外部数据或协议格式、方案显著超出请求范围、重置会改变已发布契约、用户明确要求向后兼容或迁移。