用途
该技能用于在实施功能或修复反馈之前,先确定有边界的实现范围和既有归属模块,避免直接照搬问题中建议的实现方式。它强调将建议视为证据而非已批准的 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 或架构变更的正式评审,实质性变更需先上报。