用途 该技能用于在编写提交、管理分支、发布版本和编写 GitHub Actions 工作流时提供一套统一约定,并借助脚本对工作流中的动作版本做实时核对。它自身说明:Conventional Commits、语义化版本(Semantic Versioning)和 Keep a Changelog 按公开发布的规范适用;本技能在它们之上补充提交纪律、发布约定和实时动作版本检查。
主要能力
- 提交规范:按显式路径暂存,例如 git add -- <path>...;用 git diff --cached --stat 审阅暂存集;提交信息主题格式为 type(scope): subject,使用祈使语气、小写、不加句号、不超过 72 个字符,正文说明改了什么与为什么。分支采用 feature/、fix/、docs/ 或 refactor/ 加简短描述,经拉取请求合并到默认分支。
- 发布约定:标签带 v 前缀且为附注标签,例如 git tag -a v1.2.3 -m "Release v1.2.3";发布提交为 chore(release): v1.2.3,并将 CHANGELOG.md 中 ## [Unreleased] 的内容移入新的 ## [1.2.3] - YYYY-MM-DD 标题下。资料提到完整的升级、打标签、发布流程位于 /release 技能中,但未提供该技能细节。
- Actions 版本核对:要求每条 uses: 行依据脚本本次会话输出编写。资料说明动作主版本变化快于模型训练数据,且若干流行动作已停止发布移动主标签。提供命令示例:uv run "${CLAUDE_SKILL_DIR}/scripts/check_actions_versions.py" --common 检查常用动作;uv run "${CLAUDE_SKILL_DIR}/scripts/check_actions_versions.py" actions/checkout pnpm/action-setup 检查指定动作;uv run "${CLAUDE_SKILL_DIR}/scripts/check_actions_versions.py" --validate .github/workflows/ci.yml 校验工作流文件。脚本直接查询 GitHub,覆盖第一方与第三方动作,输出应使用的引用:若最新发布的主版本存在移动主标签则给主标签(如 v7),否则给需固定的完整发布标签(如 v10.2.0)。--validate 在发现过时引用、不存在的标签以及需人工确认的 SHA 固定时以非零退出并列出。认证通过 GITHUB_TOKEN、GH_TOKEN 或 gh auth token;匿名调用每小时上限 60 次。完成标准为:工作流中每条 uses: 行都匹配本次会话脚本输出的引用,且对文件运行 --validate 退出码为 0(SHA 固定经确认后除外)。
- 权限声明:每个工作流需声明 permissions: 块,并限定到作业所需范围。
使用方式 按上述格式编写提交与发布;改动工作流时先运行版本检查脚本,再据输出填写 uses: 行,最后运行 --validate 校验文件。
项目覆盖规则 仓库的 AGENTS.md 或 CLAUDE.md 若对提交、分支、尾注或工作流有自定规则,其优先级高于上述默认值。资料列举的典型覆盖包括:是否添加 Co-Authored-By 尾注;是否直接提交到默认分支而非拉取请求,或仅允许压缩合并;工作流中的工具链选择,例如 Node 使用 pnpm(pnpm/action-setup 从 package.json 读取 packageManager,因此不设置 with: version),Python 使用 uv。
适用场景与限制 适用于遵循上述规范的 Git 提交、发布与 GitHub Actions 编写场景。资料未提供该技能的安装方式、收费情况、支持平台或与其他版本的兼容性信息,这些暂未提供。使用版本检查需具备 GitHub 令牌以避免匿名限额。