SuperAPI AI 工具集

release-please-protection

编程与开发

查看项目

更新于 11-11 01:10

技能介绍

用途

release-please-protection 是一个面向 Claude Code 的技能,用于检测并阻止对 release-please 自动化工具所管理文件的手动编辑,从而减少与自动发布 PR 的合并冲突,维护语义化版本记录和 changelog 生成流程的一致性。

主要能力

硬性保护

通过 Claude Code 的权限系统,对所有位置的 **/CHANGELOG.md 实施硬性拦截:阻止 Edit、Write、MultiEdit 操作,仅允许 Read,以便分析上下文。

软性保护

对以下包管理器清单中的版本字段触发警告与建议:

  • package.json 的 "version"(npm/Node.js)
  • pyproject.toml 的 version(Python/uv)
  • Cargo.toml 的 version(Rust/cargo)
  • .claude-plugin/plugin.json 的 "version"(Claude Code 插件)
  • pom.xml 的 <version>(Maven/Java)
  • build.gradle 的 version(Gradle)
  • pubspec.yaml 的 version(Dart/Flutter)

之所以采用软保护,是因为权限系统按文件而非字段生效,整文件拦截会妨碍 npm、cargo、uv 等工具进行合法的依赖更新。

触发场景

技能会在以下情形自动激活:直接请求编辑受保护文件;用户提及版本升级、发布或 changelog 更新;可能触及版本控制文件的大范围重构;可能包含 CHANGELOG.md 的文档更新;以及“修复所有问题”之类的全面请求。

检测与响应

编辑前依次进行:文件路径分析(若路径以 CHANGELOG.md 结尾,则说明硬性阻止及 release-please 工作流,并建议使用 Conventional Commits);内容模式匹配(若改动涉及版本字段,则警告冲突风险,提议编辑其他字段并提供提交模板);意图识别(若请求含 version、release、bump、changelog 等关键词,则主动说明工作流并检查范围内的受保护文件)。技能内置多套响应模板,覆盖 CHANGELOG.md 编辑尝试、版本字段修改、大范围重构等场景,并提供 feat、fix、BREAKING CHANGE、chore 等 Conventional Commit 模板。

使用方式

技能源文件位于 dot_claude/skills/release-please-protection/,经 chezmoi apply 后映射到 ~/.claude/skills/release-please-protection/,包含 SKILL.md(技能定义)、patterns.md(受保护文件模式参考)、workflow.md(release-please 工作流指南)。技能可与 Chezmoi Expert、Git Workflow、GitHub Actions 相关技能配合。

适用场景

适用于使用 release-please 和 Conventional Commits 管理发布流程、并且使用 Claude Code 进行开发的项目,尤其适合需要防止误改版本或 changelog、保持自动发布 PR 顺畅的团队。

限制

无法阻止:用户明确要求覆盖警告的指令;当前上下文窗口之外的文件;sed、awk 或直接 bash 编辑等外部工具;以及包含受保护文件改动的手动 git commit。紧急情况下可临时注释 ~/.claude/settings.json 中的 deny 规则,或移走技能目录以绕过限制,完成后需恢复。