release-checklist

发布检查清单

OrchestKit 的顺序式发布关卡。每一步都会报告 [PASS] 或 [FAIL]。首次失败时停止，建议修复方案，并在用户确认后继续。

加载详情：阅读 Read("${CLAUDE_SKILL_DIR}/references/release-flow.md")，了解顺序安排的原因和热修复指南。

CC ≥ 2.1.118 (M122)： 发布前关卡现在包含 claude plugin tag <version> --dry-run，用于验证清单层级。请在清单计数检查后将其加入关卡序列。参见 src/skills/chain-patterns/references/plugin-tag.md。

快速参考

类别	规则	影响	使用时机
发布前关卡	2	严重	每次发布提交前
发布提交	2	高	暂存、提交、打标签、推送

总计：2 个类别中的 4 条规则

快速开始

# Run all pre-release gates in order (stop on first failure)
npm run build && npm test && npm run test:security && npm run typecheck
bash src/skills/validate-counts/scripts/validate-counts.sh
git diff  # review before staging

发布前关卡

写入任何发布提交前都必须全部通过。参见 rules/gate-build-and-test.md 和 rules/gate-counts-and-diff.md。

步骤	命令	规则文件
1. 构建	npm run build	rules/gate-build-and-test.md
2. 测试	npm test	rules/gate-build-and-test.md
3. 安全	npm run test:security	rules/gate-build-and-test.md
4. TypeScript	npm run typecheck	rules/gate-build-and-test.md
5. 验证计数	/validate-counts	rules/gate-counts-and-diff.md
6. 差异审查	git diff	rules/gate-counts-and-diff.md

发布提交

所有关卡通过后的步骤。参见 rules/commit-staging.md 和 rules/commit-tag-push.md。

步骤	操作	规则文件
7. 更新日志	CHANGELOG.md 中存在对应条目	rules/commit-staging.md
8. 提升版本	package.json 和 CLAUDE.md 均已更新	rules/commit-staging.md
9. 暂存文件	git add <specific files> — 切勿使用 -A	rules/commit-staging.md
10. 提交	release: vX.Y.Z 常规格式	rules/commit-tag-push.md
11. 打标签	git tag vX.Y.Z	rules/commit-tag-push.md
12. 推送	运行 scripts/pre-push-confirm.sh — 先确认	rules/commit-tag-push.md

相关技能

• validate-counts — 检查计数一致性（本清单的第 5 步）
• audit-skills — 更全面的技能质量审计（在重要版本发布前运行）
• checkpoint-resume — 适用于长时间发布会话的抗速率限制流水线

常见错误

1. 在运行 npm run build 之前运行 npm test — 测试针对过期的 dist 运行
2. 使用 git add -A — 可能会意外暂存机密或无关的进行中工作
3. 忘记同时提升 CLAUDE.md 和 package.json 中的版本
4. 未经用户明确确认就推送 — 在共享远程仓库上无法撤销
5. 跳过安全测试 — 即使是补丁版本发布也绝不可跳过