用途:为 Verasic 项目的 git 提交信息提供统一规范,覆盖信息风格、禁用模式与 trailer 政策,适用于编写任何 commit message 的场景。
主要能力:规范正文位于 references/conventions.md(信息风格、禁止的 AI 会话模式及白名单、trailer 政策),references/commit-protocol.md 给出书写流程、验证步骤与 trailer 例外通道。确定性的校验层由 hooks/commit-msg 提供,可通过 lefthook 或 core.hooksPath 接入,在不涉及 LLM 的情况下剥离归属类 trailer 并拒绝机械性风格违规。
使用方式:会话中首次撰写提交信息前,先阅读上述两个参考文件,然后起草、提交,并在提交后始终按协议执行 trailer 验证。若仓库尚未接入该 hook,建议参照 commit-protocol.md 的 wiring 章节接线。审查推送前历史可使用同系列技能 /verasic-git-commits-audit。Cursor 规则仅作为指向这些文件的薄指针,不应在其他位置重复规范内容。
硬性规则:任何大小写形式都不得带 Co-authored-by: trailer,每次提交后都要验证;信息中不得出现 AI 会话用语,包括工具名称、智能体词汇、计划步骤、聊天叙述或助手口吻。
限制:安全模型参见 references/scanner-notes.md 与上游 SECURITY.md,包含预期扫描信号与信任模型说明,具体细节暂未在现有资料中展开。