SuperAPI AI 工具集

git-workspace-review

编程与开发

查看项目

更新于 10-15 17:20

技能介绍

用途:这是一个只读的预检技能,在依赖仓库状态的流程(如提交信息生成、PR 准备、发布说明)之前使用,确认工作区状态与暂存的改动符合预期。每个会话运行一次,或在暂存改动被修改后重新运行。

主要能力与步骤(需按序完成并标记进度项 git-review:repo-confirmed、git-review:status-overview、git-review:code-quality-check、git-review:diff-stat、git-review:diff-details):先用 pwd 确认目录正确,运行 git status -sb 查看当前分支与简短状态;分析其中的暂存与未暂存改动,暂存或取消暂存以让后续流程针对预期 diff;在仓库根目录运行 make lint 校验代码质量,该命令检查 ruff format、执行各插件 ruff 检查并运行 bandit,但不做任何改写,失败时会提示 make fix(会修改的配对命令);随后用 git diff --cached --stat(未暂存用 git diff --stat)查看改动统计并识别热点,在可用时运行 sem diff --format plain --staged 查看函数、类、方法级别的变化;最后用 git diff --cached 查看详细改动,归纳主题。

验证与测试:审查后运行 git status 验证工作区状态;运行 pytest plugins/sanctum/tests/test_git_workspace_review.py 验证审查流程。

不适用场景:撰写提交信息(使用 sanctum:commit-messages);完整的 PR 前门禁(使用 sanctum:pr-prep)。

限制与注意事项:不要用 --no-verify 绕过 pre-commit 钩子,应修复报告的问题;若出现合并冲突,可用 git merge --abort 回到干净状态再重试。支持的模块包括 git 命令参考(diff、status、分支操作)。关于收费、价格、平台的说明暂未提供。