SuperAPI AI 工具集

update-otel-genai-conventions

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:分析 OpenTelemetry GenAI 语义约定(semantic-conventions-genai)的变更,并在 dotnet/extensions 中产出对应的补偿性更新。约定已从合并仓库 open-telemetry/semantic-conventions 迁移到专用仓库 open-telemetry/semantic-conventions-genai,后者还托管 mcp、openai、anthropic、aws-bedrock、azure-ai-inference 约定。

主要能力:支持六种模式——审计(Mode 1)、自动驾驶一次性更新(Mode 2)、生成 CCA 提示(Mode 3)、在 Copilot Coding Agent 中实现(Mode 4)、先计划后实现(Mode 5,默认)、评审(Mode 6)。可处理 PR 引用、changelog.d 快照(commit SHA/ref/日期)、日期范围、发布版本等输入,并生成变更审计表、分类与所需动作。

使用方式:先做 dotnet/extensions 开放 PR 预检,避免重复;读取 references/file-inventory.md 确定受影响文件(如 OpenTelemetryConsts.cs、OpenTelemetryChatClient.cs、OpenTelemetryEmbeddingGenerator.cs、Common/FunctionInvocationProcessor.cs 等);按 references/change-classification.md 分类;再按 references/pr-description.md 撰写 PR 标题与描述。跨仓库使用时需改用目标仓库自身的路径、常量组织与构建测试命令。

适用场景:dotnet/extensions 的 GenAI 约定对齐;anthropic 对应 anthropics/anthropic-sdk-csharp,aws-bedrock 对应 aws/aws-sdk-net 的 BedrockRuntime 库。

限制:semantic-conventions-genai 尚无发布,CHANGELOG.md 的 Unreleased 段为空,需用 changelog.d/ 片段;schema URL 未发布,versions.env 的 SEMCONV_VERSION 不是 GenAI 版本;规范页现为 Moved 存根;PR 编号跨仓库不可互换,需加仓库前缀消歧。具体命令与文件细节暂未提供。