关于 commit-categories
一项按改动文件路径分类提交的技能，类别针对 workerd 仓库设定。它还会单独标出兼容性标志和 autogate 的变更，避免这些内容在报告中被忽略。
主要功能
- 01按变更路径分类提交
- 02为跨领域改动选定主要类别
- 03单独标注兼容性标志变更
- 04单独标注 autogate 变更
- 05省略未使用的类别
适用场景
- 01整理 workerd 变更摘要
- 02分类跨多个子系统的提交
- 03突出兼容性标志变更
- 04提醒关注新增或修改的 autogate
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/commit-categories确认已加载。
详细介绍
提交类别
根据提交涉及的文件对提交进行分类；如果提交涉及多个类别，则归入主要类别。
| 类别 | 路径模式 |
|---|---|
| API | src/workerd/api/（不包括 node/ 和 pyodide/） |
| Node.js 兼容性 | src/workerd/api/node/、src/node/ |
| Python | src/workerd/api/pyodide/、src/pyodide/ |
| Rust | src/rust/ |
| Cloudflare API | src/cloudflare/ |
| I/O | src/workerd/io/ |
| JSG | src/workerd/jsg/ |
| 服务端 | src/workerd/server/ |
| 构建 | build/、MODULE.bazel、BUILD.bazel |
| 类型 | types/ |
| 文档 / 配置 | 文档、Agent/工具配置、.md 文件 |
| 测试 | 仅修改测试文件 |
| 其他 | 不属于以上类别的任何内容 |
跨领域特别提示
这些不是主要类别，而是额外的特别提示部分：只要提交涉及相关文件，就应与主要类别一并列出。单个提交可以同时归入一个主要类别和一个或多个特别提示部分。
| 特别提示 | 触发条件 |
|---|---|
| 新增/更新兼容性标志 | 修改 src/workerd/io/compatibility-date.capnp，或在代码中新增 compatibilityFlags 引用 |
| 新增/更新自动门控 | 修改 src/workerd/io/supported-autogates.h，或新增自动门控注册 |
触发任一特别提示时，应在主要类别之后添加专门的部分，列出每个新增或修改的标志/门控，并附上简短说明。绝不能将这些内容埋在常规类别的项目中——这是需要审阅者和发行说明读者立即注意的重要事项。
分类方法
- 对每个提交运行
git diff-tree --no-commit-id --name-only -r <hash>，列出修改的文件。 - 根据上述路径模式匹配修改的文件。
- 将提交归入涵盖其大部分修改的类别。
- 对于涉及多个区域的提交，将其列在主要区域下（修改文件最多或变更最重要的区域）。
- 根据跨领域特别提示的触发条件检查每个提交。如果提交新增或修改了兼容性标志或自动门控，除主要类别外，还应在相应的特别提示部分中注明。
- 从输出中省略空类别和未使用的特别提示部分。
评论
支持 Markdown