SuperAPI AI 工具集

implementation-strategy

编程与开发

查看项目

更新于 11-14 21:52

技能介绍

用途

该技能用于在实施功能或修复反馈之前,先确定有边界的实现范围和既有归属模块,避免直接照搬问题中建议的实现方式。它强调将建议视为证据而非已批准的 API 设计。

主要能力

  • 记录请求结果、验收标准、受影响路径、兼容性要求和非目标。
  • 查找归属边界:读取仓库地图和 SDK 迁移指南,使用现有配置、验证、注册表、对话和资源管道。
  • 识别受影响契约的类型:公共导出、声明、配置格式、请求/响应形状、异常、CLI 选项或内部助手。
  • 对照预期 PR 基线比较归属变更;在评估已发布兼容性时单独查阅已验证的发布标签,并报告不可用或过时的发布基线。
  • 在指定边界内保留并检查相关组件,包括:OpenAI/Azure 客户端、资源、OpenAI 7、Zod 4、Agents、管道、流式与历史。
  • 避免添加新的受保护 SDK 方法、将省略选项规范化为任意默认值,或为迎合建议实现而重复 schema/对话转换。
  • 对实质性公共 API 或架构变更,在扩大差异前上报。
  • 根据变更契约匹配测试:使用归属区域旁的现有单元测试;对于 SDK 边界,检查 src/tests/integration/sdk-compat.test.ts、sdk-types.test.ts 和 sdk-migration-feedback.test.ts,并在运行这些测试前构建。
  • 对涉及的安全表面,审查相关信任边界(不可信配置、提供方响应、对话内容或评估输入),并确认副作用前的验证位置,保持审查范围限于当前变更。
  • 使用 AGENTS.md 分类反馈:修复引入/恶化的缺陷和狭义必要修正,单独记录更广泛的改进。

使用方式

该技能以策略指南形式提供,需结合具体实现任务执行上述步骤。资料未提供具体安装命令或调用方式。

适用场景

适用于在 openai/openai-guardrails-js 仓库中进行实现或反馈修复前,需要界定范围、识别归属模块、评估兼容性和规划测试的场景。

限制

资料未提供收费、价格、平台要求或效果保证等信息。该技能不替代公共 API 或架构变更的正式评审,实质性变更需先上报。