用途:这是 durably 仓库在发布前执行的完整性检查流程(Skill),目标是减少 API 变更后文档漂移带来的后续修复 PR。在升版本或发布前运行。
主要能力与流程(按资料分阶段):
- 自动检测:先运行 doc-check 的过期模式脚本 .claude/skills/doc-check/scripts/find-stale.sh,修复所有 [STALE] 命中项后再继续。
- 确定范围:与上一个发布 tag(而非 main)对比,例如 gh release list --limit 1、git log --oneline v0.10.0..HEAD、git diff v0.10.0 --stat;并将提交分类为 feat/fix/破坏性变更/docs/chore,据此判断版本号变更幅度。
- 实现检查:核对包 @coji/durably、@coji/durably-react 的 SPA hooks(hooks/)、全栈 hooks(client/)、shared/、types.ts,以及 index.ts、spa.ts 的导出完整性——新增类型与 hooks 必须导出,否则用户无法导入。
- 版本:两个包共用同一版本,遵循 semver;检查 package.json 中的 version 与 peerDependencies 范围。
- 文档:检查包内 docs/llms.md、各级 README、CLAUDE.md、Skill 文件、website/api 下各 API 页面、website/guide 下各指南、侧边栏 config.ts,以及需重新生成的 website/public/llms.txt(pnpm --filter durably-website generate:llms)。
- 示例:examples/ 下各示例需能编译并使用当前 API 模式。
- 测试:确认新功能或变更已有测试覆盖。
- 变更日志与发布说明:在 CHANGELOG.md 按包与类别分组,每个面向用户的变更一条并附 PR 号,破坏性变更需标注。
- 校验:pnpm format:fix、pnpm lint:fix、pnpm --filter durably-website generate:llms、pnpm validate。
- 版本提升:两个包的 package.json 同步升版,提交信息为 chore: bump version to 0.X.0。
- 最终检查:再次运行 find-stale.sh,须干净后方可合并发布 PR。
限制:资料未提供该技能的价格、安装方式、支持的平台等细节,相关内容暂未提供。