SuperAPI AI 工具集

pravidhi-commit-protocol

编程与开发

查看项目

更新于 10-16 03:47

技能介绍

用途:在 Git 仓库内驱动完整、可重复且带质量约束的编码工作流,适用于实现功能、修复缺陷或重构代码的任务。目标是原子化提交、无密钥泄露、减少 diff 噪声,并在推送前通过 CI。

主要能力分阶段展开:

  1. 仓库卫生:检查当前分支,若在 main/master/dev/production 等受保护分支则停止并询问是否新建 feature 分支;同步远端并检查未提交变更;对未跟踪文件做 .gitignore 分类,已知构建产物、日志、生成文件、密钥与环境文件、IDE 文件可直接加入并单独提交。
  2. 依赖与安全审计:按生态运行 npm audit、pip-audit、cargo audit、govulncheck、bundle audit、composer audit 等;按规定严重级别决定停止或继续,修复后单独提交。
  3. 编码前质量检查:格式化 dry-run 与 linter 只检查模式;若超过阈值(默认 10 个文件需重排格式)则停止询问;可读取并存储用户偏好。
  4. CI/CD 预验证:检测各类 CI 配置,提取可本地运行的步骤并按顺序执行,同时运行 pre-commit/pre-push 钩子。
  5. 重构安全网:仅针对大重构,输出回退命令、已知风险和回滚验证步骤,并打 pre-refactor 标签。
  6. 实现:明确任务、文件和范围,遵循现有项目架构与命名约定,不引入越界改动。
  7. 编码后验证:对变更文件运行格式化、lint、类型检查、测试与覆盖率、构建,仅修复机械性问题,其余询问用户;超过 50 行的日志需截断以保护上下文。
  8. 密钥检测:提交前必须运行 gitleaks、truffleHog、detect-secrets 或 git-secrets,发现疑似密钥即停止。
  9. CHANGELOG:检测存在性,按任务类型决定是否提示更新条目。
  10. 提交与推送:生成原子、高质量提交信息。
  11. 拉取请求:通过 CLI 生成 PR/MR 或给出链接。

使用方式:作为代理技能触发,各阶段根据提示或用户指令暂停确认。限制:多数行为依赖项目实际配置与用户决策;格式化阈值默认硬编码为 10;具体收费、平台支持与效果资料未提供。