SuperAPI AI 工具集

w-commit

编程与开发

查看项目

更新于 10-15 15:43

技能介绍

用途

w-commit 用于在收到提交请求时,按仓库约定审查并提交任务预期改动。它强调在暂存任何内容之前,先检查已暂存和未暂存的改动,以及授权任务范围。

主要能力

  • 检查已暂存与未暂存的改动,并确认授权任务范围。
  • 创建新分支时,先执行 git fetch origin,再执行 git switch -c <name> --no-track origin/main,避免使用过期的本地 main。
  • 检查 diff,区分任务自有改动与无关工作,包括预先暂存的文件。
  • 若预期提交无法安全分离,要求澄清文件范围。
  • 暂存前检查:若行为、命令或约定发生变化,匹配的 MDX 与最近的 README 必须出现在 diff 中;否则需提供一行说明为何没有。
  • 依赖提交钩子,不使用完整的 pre-push 套件。
  • 只暂存明确属于任务的路径或代码块,不将无关或未跟踪的工作一并纳入提交。
  • 禁止使用 git add -A。
  • 禁止暂存 .env、凭据或密钥。
  • 编写 Conventional Commit:小写类型/范围,不超过 60 字符的祈使句摘要,无句号。
  • 遵循仓库特定的范围约定。
  • 通过 heredoc 传入提交信息,并在启用钩子的情况下提交。
  • 检查提交结果与剩余工作区,返回提交 ID 和范围。

使用方式

调用该技能即表示请求提交。随后按上述流程检查改动、确认范围、暂存任务自有内容、编写符合约定的提交信息并提交。提交完成后返回提交 ID 和范围。单独的提交请求不授权推送。

适用场景

适用于需要按仓库约定安全提交任务改动的场景,尤其是需要区分任务改动与无关改动、避免误提交敏感文件、并保持提交信息规范一致的情况。

限制

  • 不使用完整的 pre-push 套件。
  • 禁止使用 git add -A。
  • 禁止暂存 .env、凭据或密钥。
  • 若无法安全分离预期提交,需先澄清文件范围。
  • 单独的提交请求不授权推送。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。