SuperAPI AI 工具集

emitter-prep-for-pr

编程与开发

查看项目

更新于 11-04 20:23

技能介绍

用途:该技能面向 TypeSpec 仓库中的语言 emitter 包,帮助开发者在提交 PR 前完成校验、changeset 准备与推送。适用包仅限 http-client-python、http-client-csharp、http-client-java 三个 emitter 包,不适用于核心 TypeSpec 包(compiler、http、openapi3 等)。

主要能力:1)根据上下文(当前目录、近期改动或询问用户)确定正在处理的 emitter 包,其路径为 packages/<package-name>/;2)在包目录运行 npm run build、npm run format、npm run lint -- --emitter 完成构建、格式化与 lint;3)在仓库根目录运行 pnpm format;4)检查当前分支是否已有 changeset;5)若无 changeset,则按 changeKind 与 message 创建 .chronus/changes/ 下的变更文件;6)暂存、提交并推送。

使用方式:按步骤执行命令。若构建、格式化或 lint 任一步失败,应报告错误并停止。仓库根目录执行 pnpm format 可能改动 emitter 包之外的文件(如 .devcontainer/、其他包),暂存时只应暂存 packages/PACKAGE_NAME/、.chronus/changes/ 与 .github/skills/ 内的文件,其他格式化改动用 git checkout -- <file> 丢弃。检查 changeset 时通过 git rev-parse 获取分支名,在 .chronus/changes/ 中匹配分支名,未匹配到则输出 NO_CHANGESET 并进入创建流程。创建 changeset 需先确定 changeKind(internal、fix、feature、deprecation、breaking、dependencies 之一)和面向用户的简洁描述,文件名为 .chronus/changes/${BRANCH}-${TIMESTAMP}.md,内容包含 changeKind、packages 和 message。提交前展示将提交的内容并请求确认,提交信息附带 Co-authored-by: Copilot 署名,最后始终推送到 origin(用户 fork),不推送到 upstream。

changeKind 说明:internal 用于测试、CI/CD、重构、文档、技能等非用户可见改动;fix 为用户可感知的缺陷修复;feature 为新用户可见能力;deprecation 为标记弃用;breaking 为不兼容的移除或行为变更;dependencies 为依赖版本升级。包名对应关系:http-client-python 为 @typespec/http-client-python,http-client-csharp 为 @typespec/http-client-csharp,http-client-java 为 @typespec/http-client-java。

适用场景:在 TypeSpec 仓库中修改上述语言 emitter 包并准备提交 PR 时使用。限制:不适用于核心 TypeSpec 包;构建、格式化、lint 失败时必须停止;根目录格式化可能影响无关文件需手动清理;提交前需用户确认。其他细节暂未提供。