gs-git-commit 是一个 Git 提交类技能,用于把当前工作区变更整理成规范提交。它没有子命令,也不会创建拉取请求。
用途:在用户输入“/gs-git-commit”或要求提交变更时,检查并提交当前改动。
主要能力:
- 使用约定式提交信息,格式为“type: 简明描述”,可选正文补充上下文;type 包括 feat、fix、chore、docs、refactor、test、style。
- 不添加 AI 署名尾注。
- 提交前运行 git status、git diff 与 git diff --cached 审阅变更。
- 按逻辑单元分组提交:同一功能、修复或重构放在一起,无关变更分开,每个提交可独立回滚,格式化与逻辑变更分离。
- 涉及多个关注点时逐组显式暂存文件并分别提交;迁移与 schema 变更随使用它们的代码提交,测试文件随被测代码提交。
- 用户提供提交信息时,将其用作描述。
使用方式:通过运行环境的 shell、文件与搜索工具执行。遇到需要选择时询问用户。避免需要交互输入的 Git 命令;不使用 git add -p,除非运行环境能安全驱动交互,否则显式暂存文件或询问用户包含哪些文件。部分暂存仅在运行环境安全支持时使用,否则询问用户如何拆分。提交后展示所做提交,并询问是否推送;打开拉取请求属于 gs-pull-request 技能。命令失败时说明失败内容、建议修复并询问重试或停止。
不暂存的文件:
- 操作系统产物:.DS_Store、Thumbs.db、Desktop.ini、._*
- 编辑器与 IDE 文件:.idea/、.vscode/settings.json、.swp、.swo、*~
- 构建产物:_build/、deps/、node_modules/、dist/、*.beam
- 临时与调试文件:.log、.tmp、.bak、.orig、dump.rdb
- 密钥:.env、.env.(.env.sample 与 .env.example 除外)、credentials.
- 已被 .gitignore 覆盖的文件 若某文件可能属于上述列表但本次变更也需要它,暂存前询问用户。
适用场景:需要按约定式提交规范整理并提交本地 Git 变更,同时希望过滤密钥与生成文件的日常开发流程。
限制:不创建拉取请求;不添加 AI 署名;不处理推送,除非用户确认;交互式操作受限时需改为非交互方式或询问用户。