Claude Code Harness release-preflight 实战发布前检查脚本分步教程【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness什么是 release-preflight 发布前检查release-preflight是 Claude Code Harness一个通过「规划→执行→审查」自动化循环实现高质量开发的 Claude Code 开发框架内置的发布前检查脚本源码位于 scripts/release-preflight.sh。它在你对项目打 tag、发布版本之前自动完成约 10 项只读检查工作区是否干净、CHANGELOG 是否就绪、版本号是否同步、CI 是否通过等——任何一项 FAIL 都会阻止发布帮你把低级错误挡在发布之前。 在 Harness 的「Spec → Plan → Work → Review → Release」循环中release-preflight 就是最后一步 Release 的质量门禁。它检查什么9 大检查项一览脚本的核心检查按顺序执行见 release-preflight.sh 的调用序列#检查项失败影响1git 工作区是否干净无未提交改动FAIL阻断发布2CHANGELOG.md是否存在[Unreleased]段落FAIL阻断发布3版本号同步VERSION 文件与插件清单一致FAIL阻断发布4分支保护策略CCH 仓库专属FAIL阻断发布5.env与.env.example一致性 healthcheck 命令FAIL/WARN6运行时残留扫描TODO、FIXME、mockData 等WARN 告警7sprint-contract 配置文件 schema 校验FAIL阻断发布8多端镜像漂移检测opencode / codex 镜像FAIL阻断发布9多 Host 工作流冒烟测试 CI 状态FAIL阻断发布检查结束会输出一行汇总例如Summary: 7 passed, 2 warnings, 1 failed有 FAIL 时脚本以退出码 1 结束可直接被 CI 拦截。快速开始一键运行发布前检查步骤 1获取仓库git clone https://gitcode.com/GitHub_Trending/cl/claude-code-harness步骤 2运行 preflight 脚本进入仓库根目录后直接执行scripts/release-preflight.sh输出会逐项打印[PASS]/[WARN]/[FAIL]最后给出汇总。全部无 FAIL 即可放心打 tag。步骤 3读懂退出码0通过可以发布 1存在 FAIL 项必须先修复再发布常用参数与长尾场景配置--help可查看完整用法参数定义见脚本头部参数用途--dry-run试运行模式配合发布 skill 使用--root 路径检查其他仓库而非当前目录--check-adapters强制执行多端适配器Cursor/Codex/OpenCode镜像检查--skip-adapters跳过适配器检查加速日常检查环境变量自定义脚本支持用环境变量注入项目专属逻辑详见官方说明 docs/release-preflight.mdHARNESS_RELEASE_PROJECT_ROOT指定被检查的仓库根目录HARNESS_RELEASE_HEALTHCHECK_CMD替换为项目自己的健康检查命令HARNESS_RELEASE_CI_STATUS_CMD替换 CI 状态查询命令这使得该脚本是「供应商中立」的——你可以把它复制到自己的项目中使用只需配置 healthcheck 命令即可。发布流程中的配套脚本release-preflight 不是一个人在战斗Harness 的发布流水线由一组脚本协作完成发布技能skills/harness-release/SKILL.md 定义了「单一确认门禁」——用户只需确认一次后续 bump 版本号、CHANGELOG 归档、tag、Release 全流程自动执行且 dry-run 模式也会强制走 preflighttag 一致性校验scripts/verify-release-tag.sh 确保 tag 名与 VERSION 文件声明的版本严格一致如v1.2.3多 Host 冒烟测试scripts/release-preflight-host-smoke.sh 对所有支持的 AI 编码 HostClaude Code、Cursor、Codex、OpenCode 等做 fail-closed 冒烟任一 Host 失败即阻止发布发布结果验证scripts/release-verify-publish.sh 轮询 API 确认 Release 已正式公开且资源文件齐全发布前检查 release-preflight ──通过── 打 tag ── CI 自动发布 ── release-verify-publish 确认新手避坑指南⚠️工作区必须先 commit这是最高频的 FAIL 原因先git commit再跑脚本⚠️CHANGELOG 必须有[Unreleased]按 Keep a Changelog 风格维护发布前把改动写入 Unreleased 段⚠️镜像漂移要提交后再 tag如果build-opencode生成了差异文件先 commit 这些差异再重跑 preflightCI 不可用只 WARN 不 FAIL没装ghCLI 或分支尚未推送时CI 检查降级为警告不会卡住首次发布WARN 不代表能放行TODO/FIXME 残留扫描命中时脚本只警告但建议顺手清理保证发布包「干净」总结用一句话概括发布前 30 秒省你发布后 30 小时。scripts/release-preflight.sh 以只读方式把「工作区干净、CHANGELOG 就绪、版本同步、CI 通过、多端镜像一致」这些容易遗漏的检查自动化配合 harness-release 技能 的单一确认门禁让「敢点发布按钮」变成一件有证据支撑的事。【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claude Code Harness release-preflight 实战：发布前检查脚本分步教程
Claude Code Harness release-preflight 实战发布前检查脚本分步教程【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness什么是 release-preflight 发布前检查release-preflight是 Claude Code Harness一个通过「规划→执行→审查」自动化循环实现高质量开发的 Claude Code 开发框架内置的发布前检查脚本源码位于 scripts/release-preflight.sh。它在你对项目打 tag、发布版本之前自动完成约 10 项只读检查工作区是否干净、CHANGELOG 是否就绪、版本号是否同步、CI 是否通过等——任何一项 FAIL 都会阻止发布帮你把低级错误挡在发布之前。 在 Harness 的「Spec → Plan → Work → Review → Release」循环中release-preflight 就是最后一步 Release 的质量门禁。它检查什么9 大检查项一览脚本的核心检查按顺序执行见 release-preflight.sh 的调用序列#检查项失败影响1git 工作区是否干净无未提交改动FAIL阻断发布2CHANGELOG.md是否存在[Unreleased]段落FAIL阻断发布3版本号同步VERSION 文件与插件清单一致FAIL阻断发布4分支保护策略CCH 仓库专属FAIL阻断发布5.env与.env.example一致性 healthcheck 命令FAIL/WARN6运行时残留扫描TODO、FIXME、mockData 等WARN 告警7sprint-contract 配置文件 schema 校验FAIL阻断发布8多端镜像漂移检测opencode / codex 镜像FAIL阻断发布9多 Host 工作流冒烟测试 CI 状态FAIL阻断发布检查结束会输出一行汇总例如Summary: 7 passed, 2 warnings, 1 failed有 FAIL 时脚本以退出码 1 结束可直接被 CI 拦截。快速开始一键运行发布前检查步骤 1获取仓库git clone https://gitcode.com/GitHub_Trending/cl/claude-code-harness步骤 2运行 preflight 脚本进入仓库根目录后直接执行scripts/release-preflight.sh输出会逐项打印[PASS]/[WARN]/[FAIL]最后给出汇总。全部无 FAIL 即可放心打 tag。步骤 3读懂退出码0通过可以发布 1存在 FAIL 项必须先修复再发布常用参数与长尾场景配置--help可查看完整用法参数定义见脚本头部参数用途--dry-run试运行模式配合发布 skill 使用--root 路径检查其他仓库而非当前目录--check-adapters强制执行多端适配器Cursor/Codex/OpenCode镜像检查--skip-adapters跳过适配器检查加速日常检查环境变量自定义脚本支持用环境变量注入项目专属逻辑详见官方说明 docs/release-preflight.mdHARNESS_RELEASE_PROJECT_ROOT指定被检查的仓库根目录HARNESS_RELEASE_HEALTHCHECK_CMD替换为项目自己的健康检查命令HARNESS_RELEASE_CI_STATUS_CMD替换 CI 状态查询命令这使得该脚本是「供应商中立」的——你可以把它复制到自己的项目中使用只需配置 healthcheck 命令即可。发布流程中的配套脚本release-preflight 不是一个人在战斗Harness 的发布流水线由一组脚本协作完成发布技能skills/harness-release/SKILL.md 定义了「单一确认门禁」——用户只需确认一次后续 bump 版本号、CHANGELOG 归档、tag、Release 全流程自动执行且 dry-run 模式也会强制走 preflighttag 一致性校验scripts/verify-release-tag.sh 确保 tag 名与 VERSION 文件声明的版本严格一致如v1.2.3多 Host 冒烟测试scripts/release-preflight-host-smoke.sh 对所有支持的 AI 编码 HostClaude Code、Cursor、Codex、OpenCode 等做 fail-closed 冒烟任一 Host 失败即阻止发布发布结果验证scripts/release-verify-publish.sh 轮询 API 确认 Release 已正式公开且资源文件齐全发布前检查 release-preflight ──通过── 打 tag ── CI 自动发布 ── release-verify-publish 确认新手避坑指南⚠️工作区必须先 commit这是最高频的 FAIL 原因先git commit再跑脚本⚠️CHANGELOG 必须有[Unreleased]按 Keep a Changelog 风格维护发布前把改动写入 Unreleased 段⚠️镜像漂移要提交后再 tag如果build-opencode生成了差异文件先 commit 这些差异再重跑 preflightCI 不可用只 WARN 不 FAIL没装ghCLI 或分支尚未推送时CI 检查降级为警告不会卡住首次发布WARN 不代表能放行TODO/FIXME 残留扫描命中时脚本只警告但建议顺手清理保证发布包「干净」总结用一句话概括发布前 30 秒省你发布后 30 小时。scripts/release-preflight.sh 以只读方式把「工作区干净、CHANGELOG 就绪、版本同步、CI 通过、多端镜像一致」这些容易遗漏的检查自动化配合 harness-release 技能 的单一确认门禁让「敢点发布按钮」变成一件有证据支撑的事。【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考