@andre-barbosa/pi-commit
为未提交的更改建议 Conventional Commit 消息
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@andre-barbosa/pi-commit。 它的用途是:为未提交的更改建议 Conventional Commit 消息 完整的 Skill 内容见:https://321skill.com/skills/andre-barbosa-pi-commit/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'运行 /commit 命令为当前所有未提交的更改生成一条提交信息。' 它会检查 Git 状态并调用模型,返回类似 'feat(user-auth): add JWT token refresh endpoint' 的建议,并打开编辑框供你调整后复制到剪贴板。
介绍
这个Skill解决了开发者在提交代码时难以写出规范、统一的提交信息的问题。在实际开发中,团队经常因提交信息格式混乱、缺少上下文而难以追溯变更历史,而手动编写符合 Conventional Commit 规范的提交信息又耗时且容易出错。
使用方式很简单,你只需要在 pi 终端中运行 /commit 命令,pi-commit 就会自动读取当前 Git 仓库的未暂存变更,调用大模型生成一条建议的提交消息。如果你希望按文件夹生成多条消息,可以传入多个路径参数,如 /commit /src /docs。生成的建议会以编辑框形式展示,支持手动调整后复制到剪贴板,整个过程不会暂存或提交任何文件。
它非常适合需要规范化提交信息的后端开发、全栈开发团队,尤其是那些已经采用 Conventional Commit 标准并希望减少人工编写负担的项目。对于多模块或微服务架构项目,按文件夹生成消息的功能能显著提升效率。
建议在团队中统一使用此工具,并结合常见的代码审查流程。需要注意的是,它主要依赖 Git 状态和模型推理,建议确保网络连接稳定,并为模型调用设置合理的预算。由于它只读取不写入,放心使用不会破坏仓库状态。
常见问题
如何安装 pi-commit?
运行 `pi install npm:@andre-barbosa/pi-commit` 即可安装,也可通过 `pi -e ./src/index.ts` 本地调试。
支持哪些提交类型?
支持 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert 共 11 种 Conventional Commit 类型。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/andre-barbosa-pi-commit/raw/index.md 读取 @andre-barbosa/pi-commit 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/andre-barbosa-pi-commit/raw/index.md(查看排版版本)