30 秒看懂
它能做什么，以及什么时候值得选
Commit Message Storyteller 是 GitHub Awesome Copilot 中把差异或变更描述转为 Conventional Commit 信息的流程，重点说明变更原因、解决的问题，以及是否应拆成多个逻辑提交。
按 Agent 安装
选择你的 Agent
路径来自 Agent 官方文档或 skills.sh 同源通用安装器。兼容状态仍以这个 Skill 的资料为准。
项目范围
.agents/skills/commit-message-storyteller/个人范围
~/.copilot/skills/commit-message-storyteller/项目范围适合团队共享；个人范围适合跨项目复用。安装器默认项目范围，加 -g 可改为个人范围。
安装命令（项目范围）
npx skills add github/awesome-copilot --skill commit-message-storyteller --agent github-copilot典型工作流
从任务到结果的典型流程
01
推断变更意图
阅读差异以识别改动内容、原因与影响范围。
02
编写提交故事
生成祈使句标题，并可加入理由与问题引用。
03
建议拆分提交
当一份差异包含多个逻辑变更时拆分无关关注点。
优点与局限
优点与使用边界
显著优点
- 通过保留意图而非复述文件名来改善提交历史。
- 处理破坏性变更、问题引用与逻辑独立工作。
潜在缺点与局限
- 仅凭差异通常无法得知真实动机、用户影响或问题背景。
- 该 Skill 只起草信息，并不能证明变更已测试或适合提交。
适合人群
适合哪些人
→
维护清晰项目历史的开发者
→
规范 Conventional Commit 信息的团队
使用前须知
使用前需要检查的风险
中
从代码误判变更意图
生成叙述可能自信地归因于差异并未证明的理由；提交前应确认动机、问题引用、范围和破坏性变更状态。
安全说明
如何理解它的权限
- 把差异粘贴到外部聊天服务前检查是否含密钥。
- 不要在公开提交历史中包含机密问题细节。
这不是安全认证。 第三方评级仅作为标注来源的参考信息展示；SkillSignal 尚未独立执行或安全审查此 Skill。
软件包内容
已收录文件
SKILL.md上游软件包内容来源可查
references/conventional-commits-guide.md上游软件包内容来源可查
标签
Git规范提交写作
SkillSignal 原创编辑资料，依据 GitHub Awesome Copilot 固定提交 318066d2 整理，核对日期 2026-08-20；未进行独立运行或安全认证。