用途:指导 FastMCP 维护者完整地切一次发布(cut a release),适用于主版本 main 分支与 release/3.x 维护分支;每一步都针对所属分支执行,包括文档 PR,因此维护性条目会落在维护分支自己的 changelog 中新 3.x 条目之上。
主要能力:预览待发布内容(git log 与 GitHub generate-notes)并生成贡献者致谢 JSON;审查归属候选,为人工作者、最终合并提交与问题上报者建议共享署名,排除已知智能体身份与机器人;补齐首次贡献者并统计总贡献者数与首次贡献者数;拟定发布标题(两到四词、贴合主题的双关语)与手写说明;生成文档 changelog 条目并做链接校验;打标签触发 Publish fastmcp-slim 到 PyPI,并扇出至 fastmcp-tasks、fastmcp-remote、fastmcp;确认各包版本;仅主版本发布时合并 published-docs 并等待 Deploy docs 运行,最后通过 markdown 端点校验。
使用方式:按资料中的命令执行,例如先 git fetch 与 gh api releases/generate-notes 预览,再用 uv run scripts/release_contributor_credit.py 生成归属候选;文档条目用 uv run .agents/skills/release/scripts/changelog_entry.py,随后在 docs 下运行 npx --yes mint@latest broken-links 校验;打标签用 gh release create v<new> --target <branch> --title ... --notes-file /tmp/release-notes.md,并 watch 相关 workflow。
适用场景:主版本发布、维护分支补丁、按需手动发布文档(publication commit 必须与 main 的 tree 完全一致)。
限制:PyPI 发布不可变,发布出错只能追加补丁而非重新打标签;维护性发布不打点 published-docs;--generate-notes 会原样复制 PR 标题,含 <1、{、} 会破坏 MDX;Mintlify 的 GitHub App 自建可能跳过或失败,只有 Deploy docs 运行的结论才算数;队列拥堵时该运行最多等待 40 分钟,需在故障清除后用 gh workflow run deploy-docs.yml --ref published-docs 重跑。资料未提供收费或价格信息。