SuperAPI AI 工具集

astro-pr-writer

编程与开发

查看项目

更新于 10-16 01:49

技能介绍

用途:在用户提出创建、开启、起草、更新 Astro PR,或更新 PR 标题、正文/描述、编写 PR 说明与摘要时使用,帮助评审者快速理解改动意图、行为变化与验证方式。

主要能力:

  1. 生成友好的 PR 标题:用自然、简洁、具体的语言描述结果,不使用 fix:、feat:、docs: 等提交前缀,也不使用 fix(cloudflare): 这类带作用域的提交风格标题。
  2. 按固定结构编写正文:## Changes、## Testing、## Docs 三段。Changes 说明行为变化及为何重要、实现细节及影响;Testing 列出新增或修改的测试代码及其覆盖内容、已有断言为何变更;Docs 说明是否需要文档改动,不需要时用一句话说明原因,需要时链接文档 PR。
  3. 内容取舍:Changes 不写“添加了测试”“更新了 fixture”“添加了 changeset”或无行为影响的内部流程记录;Testing 不写测试通过、运行的命令或通过数量(这些由 CI 体现)。
  4. 简洁优先:默认每节 1–2 条要点,只有改动确实复杂时才增加;典型补丁的正文应能让评审者 30 秒内读完。
  5. Changeset:修改包的 PR 必须包含 changeset,仅 examples/* 改动可豁免。需要加载 changeset 技能来创建 changeset 文件并撰写消息,涵盖文件创建、格式、版本提升类型和消息约定。发 PR 前先检查是否已有 changeset;若修改了包却没有,应先创建,不要直接发 PR;正文 Changes 部分不要提及“添加了 changeset”。

发布前自检:标题是否便于评审(非提交风格);Changes 是否描述行为/实现/影响;Testing 是否列出新增或改动的测试代码而非测试运行结果;Docs 决定是否明确;修改包的 PR 是否已在 .changeset/ 中存在 changeset 文件,缺失则先创建。

限制:资料未提供具体安装命令、支持平台、收费信息,也未给出除 Astro 仓库外的适用范围;该技能面向 Astro 项目的 PR 写作流程。