GitHub Release Workflow — GitHub 发布工作流程

GitHub Release Workflow Skill 是一种用于专业 GitHub 发布的标准化工作流程。 重要：发布前请务必更新 README.md 和文档！

前置条件 Git 已安装 GitHub CLI (gh) 已认证 Git 仓库已初始化

快速命令 完整发布流程 # 1. 确保工作树干净 git status # 2. 运行测试和格式化 pip install -e ".[dev]" pytest black lib/ tests/ # 3. 更新 pyproject.toml 中的版本 # 编辑：version = "2.1.0" # 4. 更新 CHANGELOG.md # 添加新节，包含今天的日期 # 5. 更新 README.md （重要！） # - 更新版本徽章 # - 更新功能列表 # - 更新项目结构（如有变化） # - 更新路线图表 # 6. 更新其他文档（如有需要） # - docs/.md # - API 文档 # - 示例 # 7. 暂存和提交 git add . git commit -m "release: v2.1.0 - 描述" # 8. 创建标签 git tag -a v2.1.0 -m "Version 2.1.0" # 9. 推送 git push git push origin v2.1.0

README 更新检查清单 发布新版本时，请务必更新 README.md： 项目 描述 版本徽章 更新版本-x.x.x-blue 功能列表 添加新功能，移除过时功能 项目结构 反映新文件/目录 安装 更新依赖关系（如有变化） 使用 添加新示例（如有需要） 路线图 将当前版本移到已完成，添加下一个 API 文档 更新 API（如有变化）

约定式提交格式 <类型>(<范围>): <描述> 类型：feat, fix, docs, style, refactor, test, chore, release 示例：feat(memory): 添加 SQLite 支持 fix(vitality): 修正能量计算

版本格式 MAJOR.MINOR.PATCH

• MAJOR：破坏性变化
• MINOR：新功能（向后兼容）
• PATCH：错误修复

分支策略 main（稳定）↑ develop（集成）↑ feature/（新功能）

GitHub 发布（可选） gh release create v2.1.0 \ --title "Version 2.1.0" \ --notes "发布说明"

请参阅 完整规范：github-release-workflow/SPEC.md 保持变更日志：https://keepachangelog.com/ 语义版本控制：https://semver.org/ 约定式提交：https://www.conventionalcommits.org/