【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载本指南围绕 gsd-core 仓库引入的 Changeset-fragment 工作流展开讲解如何让每个 PR 通过一个独立变更片段fragment彻底消除多人协作时 CHANGELOG.md 的合并冲突并让发布期的渲染、校验与归档全链路自动化。读完本文你将掌握片段格式规范、脚手架命令、CI 强制规则、退出码契约以及发布时的渲染与归档机制可直接在 gsd-core 及同类仓库中落地实践。gsd-coreGit. Ship. Done在多个协作场景中饱受 CHANGELOG.md 合并冲突困扰两个 PR 同时编辑### Fixed区块时git 无法在没有人工介入的情况下确定串行化顺序必然冲突。为解决这一问题仓库在 PR #2975 下放置一个random-name.md片段文件发布时由npm run changelog:render统一汇总进 CHANGELOG.md 并删除已消费的片段。本文基于 eager-hawks-rally.md 这一原始变更说明结合 .changeset/README.md、scripts/changeset/ 下的全部工具源码与 package.json 中的 npm 脚本完整还原该工作流的定义、实现与实战用法。为什么需要 fragment冲突的本质与解法冲突根源共享行上的写入竞争两份 PR 都编辑 CHANGELOG.md 的### Fixed区块时git 需要人工判断哪一行在前、哪一行在后因此合并必然冲突。而两个 PR 各自新增一个独立的.changeset/unique-name.md文件时两者不共享任何行永远不会冲突。这是 .changeset/README.md 中给出的核心设计理由——用不共享行的文件系统事实替代共享文件串行化的合并难题。设计要点随机三词文件名片段文件名由三个随机英文词组成形容词-名词-动词例如eager-hawks-rally.md。随机化使并发 PR 生成重复文件名的概率极低且即使撞名也有兜底机制见下文new.cjs的原子写入与重试逻辑。片段格式规范frontmatter Markdown body 的两段式结构每个片段文件由 YAML 风格 frontmatter 和 Markdown body 组成标准格式如下--- type: Fixed pr: 1234 --- **/gsd-foo no longer drops trailing slashes** — explain the user-visible change.字段说明type变更类型仅允许 Keep a Changelog 规范定义的六种取值Added、Changed、Deprecated、Removed、Fixed、Securitypr关联的 Pull Request 编号必须是正整数body一句话描述用户可见的变更渲染后成为 CHANGELOG.md 中的条目并自动追加(#NNNN)引用后缀。解析层的严格校验parse.cjs 定义了六个结构化错误码任何不符合规范的片段都会在消费时被拒绝错误码触发条件missing_frontmatter缺少---包裹的 frontmatter 块missing_type缺少type字段invalid_typetype不在六种合法取值内missing_pr缺少pr字段invalid_prpr不是正整数如 0、负数、小数empty_bodybody 为空解析器对pr的校验尤为严格Number.isInteger(pr) pr 0缺一不可。从源码看这是刻意设计——pr: 0只允许作为脚手架阶段的临时占位合并门禁会强制要求回填真实编号。docs-exempt 标记可选body 中可包含!-- docs-exempt: reason --标记用于声明该片段豁免 docs-required 检查PR #3213。解析器要求该标记独占一行且 reason 非空否则拒绝标记会在解析时被剥离绝不泄漏到渲染后的 CHANGELOG.md 或 GitHub release notes 中。值得注意的是parse.cjs 中该正则刻意使用有界字符类[^\r\n]保证线性时间匹配防止对抗性输入引发灾难性回溯——这是仓库安全意识的直接体现。创建片段脚手架命令与原子写入标准命令node scripts/changeset/new.cjs \ --type Fixed \ --pr 1234 \ --body fix the thing — explain the user-visible change in one sentence对应的 npm 快捷方式为npm run changeset -- --type Fixed --pr 1234 --body fix the thing命令输出写入的相对路径如.changeset/eager-hawks-rally.md方便脚本捕获。参数校验与原子性new.cjs 的parseArgs对每个 flag 的取值做了防御性检查缺失值flag 后紧跟另一个--开头的 token直接报错--pr只接受纯十进制整数串正则/^\d$/浮点、十六进制、科学计数法、负数一律归一化为NaN并拒绝。type在写入 frontmatter 前即做白名单校验从源头阻止换行注入破坏片段结构。写入使用writeFileSync(target, content, { flag: wx })原子创建若文件已存在则抛EEXIST脚手架随即重新随机取名重试最多 16 次。从源码注释可以推断这一设计同时服务两个目标——并发调用不会互相覆盖且撞名会被 lint 的重复文件名检查二次拦截。词表规模new.cjs 内置 40 个形容词、40 个名词、40 个动词词表组合空间约 64,000 个唯一文件名足以支撑并发 PR 的低碰撞需求。CI 强制lint 门禁的判定逻辑npm 脚本入口package.json 定义了三个核心脚本lint:changeset: node scripts/changeset/lint.cjs, changeset: node scripts/changeset/new.cjs, changelog:render: node scripts/changeset/cli.cjs render判定优先级纯函数evaluateLintlint.cjs 将判定逻辑提炼为无副作用的纯函数返回类型化的{ ok, reason }结论测试只断言稳定枚举码而非自由文本。判定按以下优先级短路有片段内容校验失败 →fail_invalid_fragment有片段pr:字段漂移见下文→fail_pr_field_driftPR 改动包含.changeset/*.md片段README.md除外→ok_fragment_presentPR 带有no-changelog标签 →ok_opt_out_labelPR 未触及任何用户可见文件 →ok_no_user_facing_changes以上都不满足且触及用户可见文件 →fail_missing_fragment。用户可见文件的判定范围lint.cjs 通过前缀匹配识别用户可见文件前缀匹配bin/、gsd-core/、src/、agents/、commands/、hooks/精确匹配直接编辑CHANGELOG.md同样触发 lint——这是刻意堵住的旁路防止贡献者绕过 fragment 工作流直接改 CHANGELOG 蒙混过关测试、CI、文档、lock 文件不算用户可见改动它们无需片段。no-changelog 标签纯粹的内部变更豁免对确实没有用户可见影响如纯测试重构、CI 微调的 PR可添加no-changelog标签显式豁免。lint 从 GitHub Actions 事件载荷GITHUB_EVENT_PATH读取 PR 标签本地运行则通过git diff --name-only origin/next...HEAD计算变更集——注意本地基准分支是next而非mainPR #2988。pr 字段漂移检查DEFECT.CHANGESET-PR-FIELD-DRIFTPR #3316/#3325 暴露了一个常见缺陷作者先填写猜测的 issue 号或堆叠 PR 遗留编号PR 创建后没有回填真实编号。因此 lint.cjs 实现了findPrFieldDrift当事件载荷中存在真实 PR 号时逐一比对片段中的pr不一致即报fail_pr_field_drift并列出found/expected推送型非 PR运行因无载荷可比对漂移检查自动为空操作。pr: 0被文档化为初始提交期的合法占位CONTRIBUTING.md不视为漂移。判定结论的枚举reason含义ok_fragment_present已包含片段ok_opt_out_label已通过no-changelog标签豁免ok_no_user_facing_changes无用户可见变更fail_missing_fragment触及用户可见文件但缺片段fail_invalid_fragment片段内容校验失败fail_pr_field_driftpr:字段与真实 PR 号不一致发布期渲染fragment 到 CHANGELOG.md 的自动汇总render 子命令发布工作流的finalize任务自动执行维护者不应手工运行node scripts/changeset/cli.cjs render --version vX.Y.Z --date YYYY-MM-DD --allow-empty执行流程cli.cjs非递归枚举.changeset/下的所有.md片段跳过README.md逐个parseFragment任一失败即 exit 1 并列出违规文件按 Keep a Changelog 规范顺序Added→Changed→Deprecated→Removed→Fixed→Security对片段分组生成类型化中间表示IR用## [vX.Y.Z] - YYYY-MM-DD替换原有的## [Unreleased]占位块在其上方重新开一个空的## [Unreleased]写入 CHANGELOG.md 并删除所有已消费的片段文件删除失败会以fail_fragment_delete结构化上报并返回 exit 1防止重跑时重复消费。渲染前的安全门幂等保护若 CHANGELOG.md 已存在该版本带日期的标题且无残留片段视为 CI 重试的合法空操作exit 0若标题已存在但片段仍在判定为不一致状态版本被带外提升exit 1 要求人工处理。空发布占位--allow-empty保证无用户可见变更的发布也能生成带日期的标题并插入_No notable changes._占位符。预览模式--preview将渲染结果输出到 stdout不写文件、不消费片段供 rc 发布任务预览待发布版本说明PR #759。Markdown 序列化的关键细节serialize.cjs 中有一处值得注意的实现body 中的换行会被替换为\n两个空格缩进确保多段落条目的续行能被解析器的续行折叠规则/^\s/重新识别从而在parse(serialize(ir))往返测试中保持内容不丢失。反解析器 parseChangelog 同时支持单行与多行条目(#NNNN)后缀可出现在任意续行并能容错## 1.42.0链接式标题与v1.0.0前缀。配套能力extract、verify 与 GitHub Release Notesextract版本区间提取extract用于从既有 CHANGELOG.md 提取某段版本区间的条目是/gsd-update展示变更的确定性数据源修复 PR #3496 依赖模糊手工提取会静默跳过中间版本的问题node scripts/changeset/cli.cjs extract --from VERSION --to VERSION \ [--changelog FILE] [--repo dir] [--json]区间语义为--from排他、--to含。两个边界必须是稳定三元组 semverMAJOR.MINOR.PATCH仅数字接受v前缀并被剥离预发布与构建后缀如1.42.0-rc.1一律拒绝——拒绝强制转换如1.42.x→1.42.0是为了避免静默改变区间选择结果。预发布/非 semver 条目及Unreleased段在匹配时跳过并向 stderr 输出提示。退出码契约scripts/changeset/README.md 有完整规格退出码含义默认 stdout--jsonstdout0区间内存在一个或多个版本匹配版本的渲染 Markdown{ releases: [...], from: ..., to: ... }1输入错误semver 非法、缺 flag、找不到 changelog 文件无错误与用法到 stderr{ error: ..., releases: [] }2边界合法但区间内无版本stderr 提示no releases found in range{ releases: [], from: ..., to: ... }调用方应把退出码2视为空区间而非失败。默认文本模式下失败仅靠退出码传达机器消费者应传--json以获取结构化error字段。verify发布门禁node scripts/changeset/cli.cjs verify --version X.Y.Z [--changelog path]校验 CHANGELOG.md 是否存在该版本的## [X.Y.Z]标题以及日期格式## [X.Y.Z] - YYYY-MM-DD任一缺失即退出非零。这是 render→verify CI 链路的收尾确认步骤PR #690。github-release-notesGitHub 发布说明node scripts/changeset/cli.cjs github-release-notes --repo dir --from REF --to REF \ [--output FILE] [--repo-slug OWNER/REPO] [--install-command CMD] [--json]基于 ref 区间从 git 历史与片段数据生成 GitHub release notes 正文可选--output写文件、--repo-slug覆盖仓库标识、--install-command自定义安装命令提示。归档机制archived/ 的历史溯源为什么存在 archived/.changeset/archived/存放 gsd-core ≤ 1.3.1 已发布版本的片段eager-hawks-rally.md 即其中之一type: Added、pr: 2975。这些片段的用户可见说明早在 #690 回填PR #694时被手工整理进 CHANGELOG.md 的## [1.2.0]、## [1.3.0]、## [1.3.1]段落——它们从未被render消费过因为当时的 CHANGELOG 提升是人工操作步骤。双重保险绝不重复渲染archived/README.md 明确说明render及所有 changeset 工具都非递归枚举.changeset/因此archived/子目录下的任何文件都不会被拾取。这是刻意设计——若渲染这些片段将重复且错误地归属已发布的工作。这些文件仅作溯源保留严禁移回顶层目录。实战速查完整工作流一览# 1. 开发者创建片段 npm run changeset -- --type Fixed --pr 1234 --body fix the thing # 2. CI片段强制检查触及用户可见文件时必须有片段或 no-changelog 标签 npm run lint:changeset # 3. 发布渲染并消费片段release workflow 的 finalize 任务自动执行 npm run changelog:render -- --version v1.42.0 --date 2026-05-01 --allow-empty # 4. 验证确认 dated 标题落盘 node scripts/changeset/cli.cjs verify --version 1.42.0 # 5. 提取与发布说明可选 node scripts/changeset/cli.cjs extract --from 1.41.0 --to 1.42.0 --json node scripts/changeset/cli.cjs github-release-notes --repo . --from v1.41.0 --to v1.42.0要点回顾每个含用户可见变更的 PR 必须新增.changeset/随机三词.md格式为typepr body 三要素no-changelog标签是纯内部变更的合法豁免路径不确定时优先补片段发布期的渲染完全自动化维护者不手工编辑 CHANGELOG.mdarchived/是历史归档区工具非递归枚举保证其永远不会被再次渲染。延伸阅读.changeset/README.md — fragment 工作流的完整定义与操作手册scripts/changeset/README.md — 发布工具链契约规格含extract退出码契约scripts/changeset/new.cjs — 片段脚手架参数校验、原子写入与词表scripts/changeset/lint.cjs — CI 门禁纯函数判定与pr漂移检查scripts/changeset/parse.cjs — 片段解析与 docs-exempt 标记处理scripts/changeset/render.cjs — 纯渲染中间表示IRscripts/changeset/serialize.cjs — Markdown 序列化/反解析往返保证scripts/changeset/cli.cjs — CLI 入口render / extract / verify / github-release-notes.changeset/archived/README.md — 已发布片段的归档与溯源说明package.json —lint:changeset、changeset、changelog:render等 npm 脚本定义赞分享【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载相关推荐gsd-core 的 Changeset Fragments 机制基于每 PR 变更片段的 CHANGELOG 自动生成方案gsd core 的 Changeset Fragments 机制基于每 PR 变更片段的 CHANGELOG 自动生成方案 核心导读 本篇文章围绕 gsdget-shit-done 的 Changeset 片段工作流用 per-PR CHANGELOG 碎片机制消除发布记录合并冲突get shit done 的 Changeset 片段工作流用 per PR CHANGELOG 碎片机制消除发布记录合并冲突 get shit done人工智能AI 应用提示工程开发工具工作流自动化AI AgentRoo Code 版本发布全流程指南从 PR 分析到 changeset 与自动化发布的完整工作流Roo Code 版本发布全流程指南从 PR 分析到 changeset 与自动化发布的完整工作流 导读 本文基于 Roo Code 仓库内定义的 relea人工智能AI Agent代码智能体开发工具工具调用MCP Clients上一篇TypeScript 6.0前瞻如何使用gh_mirrors/ba/bases实现完美兼容性配置下一篇终极指南如何使用Azure Container Apps实现dotnet-podcasts容器化部署创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 gsd-core Changeset-fragment 工作流：从 CHANGELOG 冲突治理到自动化发布编排
【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载本指南围绕 gsd-core 仓库引入的 Changeset-fragment 工作流展开讲解如何让每个 PR 通过一个独立变更片段fragment彻底消除多人协作时 CHANGELOG.md 的合并冲突并让发布期的渲染、校验与归档全链路自动化。读完本文你将掌握片段格式规范、脚手架命令、CI 强制规则、退出码契约以及发布时的渲染与归档机制可直接在 gsd-core 及同类仓库中落地实践。gsd-coreGit. Ship. Done在多个协作场景中饱受 CHANGELOG.md 合并冲突困扰两个 PR 同时编辑### Fixed区块时git 无法在没有人工介入的情况下确定串行化顺序必然冲突。为解决这一问题仓库在 PR #2975 下放置一个random-name.md片段文件发布时由npm run changelog:render统一汇总进 CHANGELOG.md 并删除已消费的片段。本文基于 eager-hawks-rally.md 这一原始变更说明结合 .changeset/README.md、scripts/changeset/ 下的全部工具源码与 package.json 中的 npm 脚本完整还原该工作流的定义、实现与实战用法。为什么需要 fragment冲突的本质与解法冲突根源共享行上的写入竞争两份 PR 都编辑 CHANGELOG.md 的### Fixed区块时git 需要人工判断哪一行在前、哪一行在后因此合并必然冲突。而两个 PR 各自新增一个独立的.changeset/unique-name.md文件时两者不共享任何行永远不会冲突。这是 .changeset/README.md 中给出的核心设计理由——用不共享行的文件系统事实替代共享文件串行化的合并难题。设计要点随机三词文件名片段文件名由三个随机英文词组成形容词-名词-动词例如eager-hawks-rally.md。随机化使并发 PR 生成重复文件名的概率极低且即使撞名也有兜底机制见下文new.cjs的原子写入与重试逻辑。片段格式规范frontmatter Markdown body 的两段式结构每个片段文件由 YAML 风格 frontmatter 和 Markdown body 组成标准格式如下--- type: Fixed pr: 1234 --- **/gsd-foo no longer drops trailing slashes** — explain the user-visible change.字段说明type变更类型仅允许 Keep a Changelog 规范定义的六种取值Added、Changed、Deprecated、Removed、Fixed、Securitypr关联的 Pull Request 编号必须是正整数body一句话描述用户可见的变更渲染后成为 CHANGELOG.md 中的条目并自动追加(#NNNN)引用后缀。解析层的严格校验parse.cjs 定义了六个结构化错误码任何不符合规范的片段都会在消费时被拒绝错误码触发条件missing_frontmatter缺少---包裹的 frontmatter 块missing_type缺少type字段invalid_typetype不在六种合法取值内missing_pr缺少pr字段invalid_prpr不是正整数如 0、负数、小数empty_bodybody 为空解析器对pr的校验尤为严格Number.isInteger(pr) pr 0缺一不可。从源码看这是刻意设计——pr: 0只允许作为脚手架阶段的临时占位合并门禁会强制要求回填真实编号。docs-exempt 标记可选body 中可包含!-- docs-exempt: reason --标记用于声明该片段豁免 docs-required 检查PR #3213。解析器要求该标记独占一行且 reason 非空否则拒绝标记会在解析时被剥离绝不泄漏到渲染后的 CHANGELOG.md 或 GitHub release notes 中。值得注意的是parse.cjs 中该正则刻意使用有界字符类[^\r\n]保证线性时间匹配防止对抗性输入引发灾难性回溯——这是仓库安全意识的直接体现。创建片段脚手架命令与原子写入标准命令node scripts/changeset/new.cjs \ --type Fixed \ --pr 1234 \ --body fix the thing — explain the user-visible change in one sentence对应的 npm 快捷方式为npm run changeset -- --type Fixed --pr 1234 --body fix the thing命令输出写入的相对路径如.changeset/eager-hawks-rally.md方便脚本捕获。参数校验与原子性new.cjs 的parseArgs对每个 flag 的取值做了防御性检查缺失值flag 后紧跟另一个--开头的 token直接报错--pr只接受纯十进制整数串正则/^\d$/浮点、十六进制、科学计数法、负数一律归一化为NaN并拒绝。type在写入 frontmatter 前即做白名单校验从源头阻止换行注入破坏片段结构。写入使用writeFileSync(target, content, { flag: wx })原子创建若文件已存在则抛EEXIST脚手架随即重新随机取名重试最多 16 次。从源码注释可以推断这一设计同时服务两个目标——并发调用不会互相覆盖且撞名会被 lint 的重复文件名检查二次拦截。词表规模new.cjs 内置 40 个形容词、40 个名词、40 个动词词表组合空间约 64,000 个唯一文件名足以支撑并发 PR 的低碰撞需求。CI 强制lint 门禁的判定逻辑npm 脚本入口package.json 定义了三个核心脚本lint:changeset: node scripts/changeset/lint.cjs, changeset: node scripts/changeset/new.cjs, changelog:render: node scripts/changeset/cli.cjs render判定优先级纯函数evaluateLintlint.cjs 将判定逻辑提炼为无副作用的纯函数返回类型化的{ ok, reason }结论测试只断言稳定枚举码而非自由文本。判定按以下优先级短路有片段内容校验失败 →fail_invalid_fragment有片段pr:字段漂移见下文→fail_pr_field_driftPR 改动包含.changeset/*.md片段README.md除外→ok_fragment_presentPR 带有no-changelog标签 →ok_opt_out_labelPR 未触及任何用户可见文件 →ok_no_user_facing_changes以上都不满足且触及用户可见文件 →fail_missing_fragment。用户可见文件的判定范围lint.cjs 通过前缀匹配识别用户可见文件前缀匹配bin/、gsd-core/、src/、agents/、commands/、hooks/精确匹配直接编辑CHANGELOG.md同样触发 lint——这是刻意堵住的旁路防止贡献者绕过 fragment 工作流直接改 CHANGELOG 蒙混过关测试、CI、文档、lock 文件不算用户可见改动它们无需片段。no-changelog 标签纯粹的内部变更豁免对确实没有用户可见影响如纯测试重构、CI 微调的 PR可添加no-changelog标签显式豁免。lint 从 GitHub Actions 事件载荷GITHUB_EVENT_PATH读取 PR 标签本地运行则通过git diff --name-only origin/next...HEAD计算变更集——注意本地基准分支是next而非mainPR #2988。pr 字段漂移检查DEFECT.CHANGESET-PR-FIELD-DRIFTPR #3316/#3325 暴露了一个常见缺陷作者先填写猜测的 issue 号或堆叠 PR 遗留编号PR 创建后没有回填真实编号。因此 lint.cjs 实现了findPrFieldDrift当事件载荷中存在真实 PR 号时逐一比对片段中的pr不一致即报fail_pr_field_drift并列出found/expected推送型非 PR运行因无载荷可比对漂移检查自动为空操作。pr: 0被文档化为初始提交期的合法占位CONTRIBUTING.md不视为漂移。判定结论的枚举reason含义ok_fragment_present已包含片段ok_opt_out_label已通过no-changelog标签豁免ok_no_user_facing_changes无用户可见变更fail_missing_fragment触及用户可见文件但缺片段fail_invalid_fragment片段内容校验失败fail_pr_field_driftpr:字段与真实 PR 号不一致发布期渲染fragment 到 CHANGELOG.md 的自动汇总render 子命令发布工作流的finalize任务自动执行维护者不应手工运行node scripts/changeset/cli.cjs render --version vX.Y.Z --date YYYY-MM-DD --allow-empty执行流程cli.cjs非递归枚举.changeset/下的所有.md片段跳过README.md逐个parseFragment任一失败即 exit 1 并列出违规文件按 Keep a Changelog 规范顺序Added→Changed→Deprecated→Removed→Fixed→Security对片段分组生成类型化中间表示IR用## [vX.Y.Z] - YYYY-MM-DD替换原有的## [Unreleased]占位块在其上方重新开一个空的## [Unreleased]写入 CHANGELOG.md 并删除所有已消费的片段文件删除失败会以fail_fragment_delete结构化上报并返回 exit 1防止重跑时重复消费。渲染前的安全门幂等保护若 CHANGELOG.md 已存在该版本带日期的标题且无残留片段视为 CI 重试的合法空操作exit 0若标题已存在但片段仍在判定为不一致状态版本被带外提升exit 1 要求人工处理。空发布占位--allow-empty保证无用户可见变更的发布也能生成带日期的标题并插入_No notable changes._占位符。预览模式--preview将渲染结果输出到 stdout不写文件、不消费片段供 rc 发布任务预览待发布版本说明PR #759。Markdown 序列化的关键细节serialize.cjs 中有一处值得注意的实现body 中的换行会被替换为\n两个空格缩进确保多段落条目的续行能被解析器的续行折叠规则/^\s/重新识别从而在parse(serialize(ir))往返测试中保持内容不丢失。反解析器 parseChangelog 同时支持单行与多行条目(#NNNN)后缀可出现在任意续行并能容错## 1.42.0链接式标题与v1.0.0前缀。配套能力extract、verify 与 GitHub Release Notesextract版本区间提取extract用于从既有 CHANGELOG.md 提取某段版本区间的条目是/gsd-update展示变更的确定性数据源修复 PR #3496 依赖模糊手工提取会静默跳过中间版本的问题node scripts/changeset/cli.cjs extract --from VERSION --to VERSION \ [--changelog FILE] [--repo dir] [--json]区间语义为--from排他、--to含。两个边界必须是稳定三元组 semverMAJOR.MINOR.PATCH仅数字接受v前缀并被剥离预发布与构建后缀如1.42.0-rc.1一律拒绝——拒绝强制转换如1.42.x→1.42.0是为了避免静默改变区间选择结果。预发布/非 semver 条目及Unreleased段在匹配时跳过并向 stderr 输出提示。退出码契约scripts/changeset/README.md 有完整规格退出码含义默认 stdout--jsonstdout0区间内存在一个或多个版本匹配版本的渲染 Markdown{ releases: [...], from: ..., to: ... }1输入错误semver 非法、缺 flag、找不到 changelog 文件无错误与用法到 stderr{ error: ..., releases: [] }2边界合法但区间内无版本stderr 提示no releases found in range{ releases: [], from: ..., to: ... }调用方应把退出码2视为空区间而非失败。默认文本模式下失败仅靠退出码传达机器消费者应传--json以获取结构化error字段。verify发布门禁node scripts/changeset/cli.cjs verify --version X.Y.Z [--changelog path]校验 CHANGELOG.md 是否存在该版本的## [X.Y.Z]标题以及日期格式## [X.Y.Z] - YYYY-MM-DD任一缺失即退出非零。这是 render→verify CI 链路的收尾确认步骤PR #690。github-release-notesGitHub 发布说明node scripts/changeset/cli.cjs github-release-notes --repo dir --from REF --to REF \ [--output FILE] [--repo-slug OWNER/REPO] [--install-command CMD] [--json]基于 ref 区间从 git 历史与片段数据生成 GitHub release notes 正文可选--output写文件、--repo-slug覆盖仓库标识、--install-command自定义安装命令提示。归档机制archived/ 的历史溯源为什么存在 archived/.changeset/archived/存放 gsd-core ≤ 1.3.1 已发布版本的片段eager-hawks-rally.md 即其中之一type: Added、pr: 2975。这些片段的用户可见说明早在 #690 回填PR #694时被手工整理进 CHANGELOG.md 的## [1.2.0]、## [1.3.0]、## [1.3.1]段落——它们从未被render消费过因为当时的 CHANGELOG 提升是人工操作步骤。双重保险绝不重复渲染archived/README.md 明确说明render及所有 changeset 工具都非递归枚举.changeset/因此archived/子目录下的任何文件都不会被拾取。这是刻意设计——若渲染这些片段将重复且错误地归属已发布的工作。这些文件仅作溯源保留严禁移回顶层目录。实战速查完整工作流一览# 1. 开发者创建片段 npm run changeset -- --type Fixed --pr 1234 --body fix the thing # 2. CI片段强制检查触及用户可见文件时必须有片段或 no-changelog 标签 npm run lint:changeset # 3. 发布渲染并消费片段release workflow 的 finalize 任务自动执行 npm run changelog:render -- --version v1.42.0 --date 2026-05-01 --allow-empty # 4. 验证确认 dated 标题落盘 node scripts/changeset/cli.cjs verify --version 1.42.0 # 5. 提取与发布说明可选 node scripts/changeset/cli.cjs extract --from 1.41.0 --to 1.42.0 --json node scripts/changeset/cli.cjs github-release-notes --repo . --from v1.41.0 --to v1.42.0要点回顾每个含用户可见变更的 PR 必须新增.changeset/随机三词.md格式为typepr body 三要素no-changelog标签是纯内部变更的合法豁免路径不确定时优先补片段发布期的渲染完全自动化维护者不手工编辑 CHANGELOG.mdarchived/是历史归档区工具非递归枚举保证其永远不会被再次渲染。延伸阅读.changeset/README.md — fragment 工作流的完整定义与操作手册scripts/changeset/README.md — 发布工具链契约规格含extract退出码契约scripts/changeset/new.cjs — 片段脚手架参数校验、原子写入与词表scripts/changeset/lint.cjs — CI 门禁纯函数判定与pr漂移检查scripts/changeset/parse.cjs — 片段解析与 docs-exempt 标记处理scripts/changeset/render.cjs — 纯渲染中间表示IRscripts/changeset/serialize.cjs — Markdown 序列化/反解析往返保证scripts/changeset/cli.cjs — CLI 入口render / extract / verify / github-release-notes.changeset/archived/README.md — 已发布片段的归档与溯源说明package.json —lint:changeset、changeset、changelog:render等 npm 脚本定义赞分享【免费下载链接】gsd-coreGit. Ship. Done - Core项目地址https://gitcode.com/gh_mirrors/ge/gsd-core点击查看免费下载相关推荐gsd-core 的 Changeset Fragments 机制基于每 PR 变更片段的 CHANGELOG 自动生成方案gsd core 的 Changeset Fragments 机制基于每 PR 变更片段的 CHANGELOG 自动生成方案 核心导读 本篇文章围绕 gsdget-shit-done 的 Changeset 片段工作流用 per-PR CHANGELOG 碎片机制消除发布记录合并冲突get shit done 的 Changeset 片段工作流用 per PR CHANGELOG 碎片机制消除发布记录合并冲突 get shit done人工智能AI 应用提示工程开发工具工作流自动化AI AgentRoo Code 版本发布全流程指南从 PR 分析到 changeset 与自动化发布的完整工作流Roo Code 版本发布全流程指南从 PR 分析到 changeset 与自动化发布的完整工作流 导读 本文基于 Roo Code 仓库内定义的 relea人工智能AI Agent代码智能体开发工具工具调用MCP Clients上一篇TypeScript 6.0前瞻如何使用gh_mirrors/ba/bases实现完美兼容性配置下一篇终极指南如何使用Azure Container Apps实现dotnet-podcasts容器化部署创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考