用途:为仓库提供统一的 Git 提交信息规范与提交历史审计编排,既约束写提交信息的过程,也约束推送或发起 PR 前的历史检查。
主要能力: 1)写路径:撰写提交信息前先阅读 references/conventions.md(规范:信息风格、禁止的 AI 会话模式及允许清单、尾注政策)与 references/commit-protocol.md(工作流、验证步骤、尾注逃生口);起草并提交后,必须按协议执行提交后尾注校验。 2)审计路径:推送或 PR 前检查历史。在 Cursor 中用前台方式启动 verasic-commit-auditor 子代理(.cursor/agents/verasic-commit-auditor.md),传入仓库路径与参数,转述报告时按要求剥离 harness 路径、技能/规则名称、协议转储与内部配置。无子代理的环境则阅读 references/audit-protocol.md 并严格照做。审计为只读。 3)确定性层:hooks/commit-msg 是一个 git 钩子(可用 lefthook 或 core.hooksPath 接入),不涉及 LLM,会剥离署名尾注并拒绝机械性风格违规;若仓库尚未接入,建议按 commit-protocol.md 的接入章节配置。 4)来源单一:完整规范均在 references/ 下,Cursor 规则与子代理只是指向这些文件的薄指针,不应在别处复制规范。
使用方式:会话中撰写第一条提交信息前先读规范与写路径协议;提交后跑尾注校验。推送/PR 前执行审计,如需修复仅可在主对话中进行,且须用户明确批准审计报告后才可运行 --fix-trailers 修复模式。
硬性限制:任何大小写形式都不得出现 Co-authored-by: 尾注;提交信息中不得出现 AI 会话语言(工具名、代理词汇、计划步骤、聊天叙述、助手口吻);审计只读,未经用户明确批准不得改写历史。
安全性:预期扫描信号与信任模型见 references/scanner-notes.md 及上游 SECURITY.md;其余细节资料暂未提供。