SuperAPI AI 工具集

finalize-pr

部署与运维

查看项目

更新于 10-16 06:47

技能介绍

用途:在功能分支准备合并时做发布前的最终整理,包括确定变更范围、选择新版本号、同步更新版本相关文件、添加 CHANGELOG 条目、更新文档、清理注释债务,并运行 lint 与测试验证。

主要能力与流程:

  1. 判断变更:读取 pyproject.toml 中的版本,运行 git log --oneline main..HEAD 与 git diff main --stat,查看 CHANGELOG.md,必要时读取 .copilot/plans/ 下的计划文件。
  2. 选择版本:遵循语义化版本,补丁用于修复/重构/文档,次版本用于新增公共 API,主版本用于破坏性变更。
  3. 同步更新五个文件:pyproject.toml、sphinx/source/conf.py、CITATION.cff、templates/c_abi_consumer/pyproject.toml(bocpy~=MAJOR.MINOR)与 CHANGELOG.md。
  4. 添加 CHANGELOG 条目,按 New Features、Bug Fixes、Improvements、Breaking Changes、Documentation、Tests、Internal 分类。
  5. 更新 README.md、sphinx/source/ 下相关页面及模板 README。
  6. 通过 review-loop 与 editor-lens 对 diff 做注释清理。
  7. 验证:激活 venv(默认 .env314),运行 flake8 --filename='.py,.pyi'、clang-format-18 --dry-run -Werror、BOCPY_BUILD_INTERNAL_TESTS=1 pip install -e .[test] --no-build-isolation 与 pytest -vv;如涉及 C ABI 或模板,再安装并测试 templates/c_abi_consumer。
  8. 汇总版本变化、改动文件与验证结果,但不执行提交。

限制:技能不会 commit、push、打标签或发布;不跳过任何版本文件;不擅自扩大范围修复缺陷;不通过改文档掩盖缺失的公共符号;运行 pip install 前必须确认 venv。