SuperAPI AI 工具集

commit-message-storyteller

通用与其它

查看项目

更新于 10-16 08:47

技能介绍

用途:把原始 git diff 或改动描述转换为清晰、叙事化的提交信息,遵循 Conventional Commits 规范,说明意图、上下文和影响,而非简单的“update file.js”。适用于用户要求写提交信息、粘贴 diff、准备 PR 或希望改善提交历史的场景。

主要能力:依据 diff 推断改动内容、原因和触发来源;将改动映射到 feat、fix、refactor、perf、docs、style、test、chore、ci、revert 等类型;按“类型(范围): 简短祈使句摘要 + 正文故事 + 页脚(issue 引用、破坏性变更声明)”的结构生成信息;当一次 diff 含逻辑独立的改动时,按不同文件/关注点拆分为多条提交;检测到破坏性变更时自动添加 BREAKING CHANGE 页脚。

使用方式:先准备 git diff --staged、git diff 输出,或改动说明、修改文件列表;技能会从中提取上下文并生成可复制的提交信息。摘要行使用祈使语气、不超过 72 字符、无句末句号、冒号后小写;正文解释问题所在与原因、行宽不超过 100 字符,与摘要空行分隔;页脚可用 Closes #123、Fixes #456、Refs #789 等引用。

适用场景:团队或个人项目、开源贡献、PR 准备,希望提交历史具备可读性和可追溯性。

限制与边界:需至少提供 diff 或改动描述之一;无 issue 编号时可省略页脚;用户要求简短时可省略正文;改动跨多文件且无明确主题时会询问是否为单一逻辑改动;资料未提供安装命令、收费信息或平台细节。