用途:本技能是一份专家级指南,教你按 Conventional Commits 规范编写语义化提交信息,让提交同时面向人和机器传达意图,从而支持自动化工具、清晰历史和团队协作。
主要能力:提供 Conventional Commits 的基础结构说明:<type>[optional scope]: <description>,后接可选正文与可选脚注;并列出核心提交类型,包括 feat(新功能,对应 SemVer 的 MINOR)、fix(修缺陷,对应 PATCH)、BREAKING CHANGE(破坏性变更,对应 MAJOR)、docs、style、refactor、perf、test、chore、ci。它还包含多个子技能:Summary(规范与核心概念速览)、Examples(不同场景的真实提交示例)、Specification(完整技术规范与要求)、FAQ(常见问题与实践指导),分别通过 ./summary/SKILL.md、./examples/SKILL.md、./specification/SKILL.md、./faq/SKILL.md 查看,或使用 skill_use(superpowers_writing_git_commits_summary) 等方式调用。
使用方式:先读 Summary 快速理解核心概念,再看 Examples 了解不同场景对应哪种类型,随后查 Specification 获取详细规则,最后参考 FAQ 解决常见疑问。关键原则是清晰、一致、结构化、原子化(尽量一次提交只做一个逻辑变更)、机器可读。
适用场景:为受版本控制的代码编写语义化提交;需要清晰提交历史的团队;构建解析提交信息的自动化工具;配合语义化版本、生成自动化 CHANGELOG、向相关方说明变更性质。该技能被 /project:do:commit 引用,用于引导生成语义化提交。
限制:资料未提供可安装命令或运行依赖;未说明具体支持的平台、收费方式或效果保证。许可证为 Creative Commons - CC BY 3.0,来源为 Conventional Commits v1.0.0。