git-workspace-review

提交前只读检查工作区状态与暂存变更

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:git-workspace-review。
它的用途是:提交前只读检查工作区状态与暂存变更
完整的 Skill 内容见:https://321skill.com/skills/git-workspace-review-x-3/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我用 git-workspace-review 检查当前工作区状态和暂存变更。' 它会运行工具并输出类似 '工作区干净,暂存区有 3 个文件变更,均为预期内容' 的结果。如果发现未跟踪文件或暂存内容异常,会给出明确警告,方便你及时调整。

介绍

在提交代码或发起 Pull Request 之前,你是否曾因工作区有未跟踪文件、暂存区包含意外变更而踩坑?git-workspace-review 是一款只读预检工具,能在几秒内帮你确认工作区是否干净、暂存变更是否和预期一致,避免将脏数据或错误代码提交到仓库。

使用方式非常简单:在 git 工作目录下运行该工具,它会自动扫描工作区状态和暂存区内容,并以清晰的可读格式输出结果。整个过程不会修改任何文件,适合作为 Git 钩子或 CI 流水线中的前置检查步骤。

适合所有需要频繁提交代码的开发者,尤其是多人协作的团队。无论是前端、后端还是全栈工程师,都可以在每次 commit 前快速验证暂存集是否“干净且正确”,减少因误提交导致的回滚或代码审查返工。

建议将 git-workspace-review 集成到 pre-commit 钩子或 CI 的 preflight 阶段,作为自动化质量门禁的一部分。注意它只做只读检查,不提供自动修复功能,如果发现问题仍需手动调整。

核心特点

不同于一般的代码检查工具(如 lint 或静态分析),git-workspace-review 专注于工作区和暂存区的状态校验,以只读方式确保暂存变更的完整性和正确性,是提交前最后一道“安全网”。

注意事项

不适合需要自动修复文件或修改工作区内容的场景,它只做只读检查。

常见问题

如何将 git-workspace-review 集成到 pre-commit 钩子?

在 .git/hooks/pre-commit 文件中添加一行命令调用该工具,如果返回非零则阻止提交。

它支持检查哪些工作区状态?

支持检查未跟踪文件、已修改未暂存文件、暂存区变更内容等,输出清晰的状态摘要。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/git-workspace-review-x-3/raw/index.md 读取 git-workspace-review 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。