// 自动生成 CHANGELOG，基于 git 提交历史和 pipeline 产物信息，遵循 Conventional Commits 和 Keep a Changelog 规范
| name | devops/changelog-generation |
| description | 自动生成 CHANGELOG，基于 git 提交历史和 pipeline 产物信息，遵循 Conventional Commits 和 Keep a Changelog 规范 |
| version | 1.0.0 |
| agent | devops |
| type | workflow |
| user-invocable | false |
| agent-invocable | true |
| dependencies | ["devops/deployment-process"] |
| triggers | ["部署成功完成后","需要生成版本变更日志时","发布新版本时"] |
在部署成功完成后自动生成或追加 CHANGELOG，记录本次发布的所有变更。适用于：
Git 历史解析：
# 获取从上次 tag 到 HEAD 的所有提交
git log $(git describe --tags --abbrev=0 2>/dev/null || git rev-list --max-parents=0 HEAD)..HEAD --pretty=format:"%H|%s|%an|%ai"
type(scope): descriptionPipeline 产物读取：
.boss/<feature>/prd.md → 功能描述和用户价值.boss/<feature>/deploy-report.md → 部署环境和版本信息.boss/<feature>/tasks.md → 完成的任务列表版本号确定：
package.json 中的 versionYYYY.MM.DD按 Conventional Commits 规范分类：
| 类型 | CHANGELOG 分类 | 说明 |
|---|---|---|
feat | Added | 新增功能 |
fix | Fixed | 修复问题 |
perf | Performance | 性能优化 |
refactor | Changed | 重构（非功能变更） |
docs | Documentation | 文档更新 |
style | (不记录) | 代码格式 |
test | (不记录) | 测试相关 |
chore | (不记录) | 构建/工具变更 |
BREAKING CHANGE | ⚠️ Breaking Changes | 破坏性变更（始终置顶） |
对于非 Conventional Commits 格式的提交：
## [版本号] - YYYY-MM-DD
### ⚠️ Breaking Changes
- 破坏性变更描述 ([commit-hash])
### Added
- 新功能描述（来自 PRD 的用户价值说明） ([commit-hash])
### Changed
- 变更描述 ([commit-hash])
### Fixed
- 修复描述 ([commit-hash])
### Performance
- 优化描述 ([commit-hash])
两种输出模式：
.boss/<feature>/changelog.mdCHANGELOG.md，将新版本内容追加到文件顶部（在 # Changelog 标题之后）追加逻辑：
读取现有 CHANGELOG.md
→ 找到第一个 ## [version] 行
→ 在其前面插入新版本内容
→ 写回文件
如果项目无 CHANGELOG.md，则创建包含标准头部的新文件：
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/).
## [版本号] - 日期
...
.boss/<feature>/changelog.md 必须生成CHANGELOG.md，同步更新BMAD 全自动研发流水线编排器。编排 9 个专业 Agent（PM、架构师、UI 设计师、Tech Lead、Scrum Master、开发者、QA、DevOps）从需求到部署一气呵成。 Triggers: 'boss mode', '/boss', '全自动开发', '从需求到部署', '帮我做一个', 'build this', 'ship it', '全流程', '自动化开发', '一键开发', 'start a project', 'new feature' Does NOT trigger: - 单文件修改或简单 bug 修复（直接编辑即可） - 纯代码阅读或解释（使用 read 工具） - 已有 pipeline 正在运行时的重复启动 Output: 完整项目代码 + PRD/架构/UI/测试/部署文档，写入 .boss/<feature>/ 目录
从CEO/战略视角进行商业价值评审，评估市场契合度、ROI、竞争优势、风险和战略对齐
设计变体模式，产出2-3个设计方案及 tradeoff 分析，供用户选择后确定最终方案
前端测试编写指南，包括单元测试、集成测试和E2E测试的编写方法和最佳实践
Playwright E2E 测试完整方法论，涵盖项目初始化、Page Object Model、认证复用、API Mock、视觉回归、多浏览器测试、CI 集成和调试技巧
测试执行方法，包含测试框架检测、测试运行、结果解析