dart-package-maintenance

此技能提供了一套符合 Dart 社区最佳实践的包维护系统化方法。适用于包维护者与管理协作存储库的软件工程师，旨在确保版本控制的一致性、发布历史的透明度以及发布周期的可靠性。通过遵循这些指南，开发人员可以减少下游中断，并为最终用户提供清晰且具影响力的发布说明。

• 语义化版本控制 (SemVer) 的应用：根据重大变更、功能新增或错误修复正确应用主版本、次版本与修补版本号。

• 自动化一致性检查：确保 pubspec.yaml 中的版本字段与 CHANGELOG.md 的标题保持同步。

• 发布工作流程管理：处理进行中 (WIP) 版本、Git 标签发布以及准备 pub.dev 发布包的最佳实践。

• Pull Request 与代码审查标准：维持干净提交记录的指导、处理合并冲突的建议，以及有效的 PR 沟通技巧。

• 以用户为中心的文档记录：筛选变更日志内容的策略，强调用户可见的影响，而非内部重构或仅针对测试的变更。

• 当准备发布新版本或在共享存储库中合并重大变更时，请使用此技能。

• 在修改版本元数据之前，务必通过 Git 或 pub.dev 验证当前的发布标签，以避免版本冲突。

• 变更日志应保持清晰沟通；省略不影响公共 API 的内部变更。

• 在处理 PR 冲突时，建议将 main 分支合并至功能分支，以保留审查历史背景与评论。

• 发布后请立即在版本字符串中加上 -wip 后缀，以标识包目前处于开发状态。