commit-safe

commit-safe 技能是专为 Git 工作流程设计的智能助手，旨在通过强制执行严谨的暂存实践来提升代码质量与透明度。它非常适合在 Git 管理的存储库中工作，并希望避免使用「git add -A」或「git add .」等可能导致提交过大或误入敏感文件的软件工程师与技术研究人员使用。通过监控工作目录的状态，此代理会主动提供有关文件暂存、提交结构化以及遵循语义化提交规范的指导。

• 主动拦截潜在的批量暂存操作，并建议在完成提交前通过 git status 与 git diff --stat 查看变更。

• 强制执行清晰的语义化提交消息规范（例如：feat, fix, docs, refactor, test），确保 Git 历史记录干净且易于搜索。

• 提供通过自定义 Shell 脚本（scripts/commit.sh）的封装接口，确保所有提交皆已签署并正确标记。

• 鼓励将相关变更进行逻辑分组，促进原子化提交（atomic commits），让代码审查更高效。

• 在检测到多文件修改或高风险存储库状态时，提供实时的操作建议。

• 适用于对提交记录整洁度要求极高的研究模板或专业开发环境。

• 严格禁止提交如 .env 或本地凭证文件等敏感信息，并通过前置确认机制进行防护。

• 要求开发者明确暂存特定文件，有效地将复杂变更拆解为更小、易于管理的区块。

• 运作机制为监控工作树变更，并在暂存操作发生前与用户互动以确认其意图。

• 建议与项目自有的提交处理脚本整合使用，以防止 AI 签名泄漏并维护标准化的文档编写标准。