SuperAPI AI 工具集

changeset

编程与开发

查看项目

更新于 10-16 07:27

技能介绍

用途:为面向用户的代码变更生成 changeset、更新文档、起草博客条目并更新技能。

主要能力:分析当前分支与 master 的差异,识别被修改的包并按影响类型(功能、修复、破坏性变更)分组;识别暴露该变更的传递依赖;检查 .agents/skills/、.cursor/skills/ 和 packages/*/.agents/skills/ 中是否有被修改的技能;确定受影响包(直接修改的包,以及接口或行为暴露时的传递依赖,如 @data-client/endpoint 同时选择 @data-client/rest、@data-client/graphql;@data-client/core 或 @data-client/normalizr 同时选择 @data-client/react、@data-client/vue)。

使用方式:对每个不同变更运行 yarn changeset,选择所有受影响包(直接加传递),选择合适版本升级(patch/minor/major);1.0 以下包对破坏性变更使用 minor。撰写 markdown 正文时遵循正文质量要求:以影响开头,用用户词汇命名公共 API,必要时给出最小代码示例,破坏性变更使用 Before/After 段落。随后更新 docs/ 中的主要文档,搜索 docs/、packages/*/README.md 和根 README.md 中所有被改 API 的用法并更新;新导出添加到相关 API 参考页。更新发布博客:在 website/blog/ 找最新草稿(frontmatter 含 draft: true),按 @website/blog/.cursor/rules/blog-posts.mdc 添加,放入合适概念分类,附代码示例并链接 PR/commit 与相关文档,破坏性变更加入摘要的 Breaking Changes 部分并带锚点链接。更新技能:若代码变更影响现有技能描述的工作流则更新,若引入新 API 或模式则加入相关技能;技能变更不需要 changeset。

写作视角:所有面向用户的文本从库用户角度出发,回答用户看到什么出错、现在什么可用;避免内部名称(条件类型、分支名、SoftPathArgs 等辅助类型、文件路径、PR 编号),除非读者是维护者。

格式:首行用动作动词(Add、Fix、Update、Remove);破坏性变更以 BREAKING CHANGE: 或 BREAKING: 前缀;正文先写用户结果;新导出用 "New exports:" 加项目符号列表。代码示例:修复可用 // Before: / // After: 注释或两个小块;破坏性变更用 #### Before 和 #### After 标题加完整片段;多场景用简短引导行或带标签的独立代码块。所有 markdown 内容遵循 @.cursor/rules/markdown-formatting.mdc。

限制:资料未提供该技能的具体安装命令、收费信息或平台支持范围。