用途:这是 mcp_flutter 仓库维护者的操作指南,处理发布、CHANGELOG、版本号锁定、文档和 CI,不面向终端 Flutter 应用用户。
主要能力与用法:
- 发布优先走 release-please(main 分支);仅在该路径受阻时手动发布。合并含 conventional commit(feat:/fix:/docs:)的 PR 到 main,等待 release-please.yml 生成 Release PR,检查 VERSION、CHANGELOG、pubspec、plugin pins 后合并,标签触发 release.yml 与 pub_publish.yml。
- 版本同步:改根 VERSION 后依次运行 make sync-version、make sync-skills、make check-contracts;tool/release/sync_version.sh 会从根 VERSION 推导各版本点。
- CHANGELOG:在 ## [Unreleased] 下按 Added/Changed/Fixed/Documentation 记录,保留文件顶部 <!-- markdownlint-disable MD052 -->,代码标识用反引号。合并前跑 bash tool/contracts/check_changelog_markdown.sh。
- 技能维护:新增 plugin/skills/<id>/SKILL.md 并把 id 加入 build_skill_assets.dart 的 expectedSkillIds,运行 make sync-skills。
- 手动发布:更新 CHANGELOG 与 VERSION,make sync-version、make sync-skills、make check-contracts,提交 chore: release X.Y.Z,打标签 git tag vX.Y.Z 并推送;本地构建用 make release-artifacts 或 bash tool/release/build_release_artifacts.sh --version X.Y.Z。
限制:pub.dev 自动发布需各包先手动首发并由 pub.dev Admin 启用 GitHub Actions 发布(标签模式 v{{version}});harness/video 属独立仓库,不在本插件树维护;不要编辑 .cursor/plans/ 中的计划文件。其余细节暂未提供。