SuperAPI AI 工具集

git-precommit

写作与研究

查看项目

更新于 10-16 07:58

技能介绍

用途:该技能用于论文写作项目在 git commit 之前进行最终把关,同时兼顾代码类项目的提交前检查。触发词包括 commit、推送、做完了、收工、快速 commit。

主要能力:分为通用 Hooks 与 Paper Hooks 两类。通用 Hooks 覆盖记忆同步(G1 memory-sync)、README/CHANGELOG/ROADMAP 更新(G2-G4)、架构检查(G5)、项目一致性审计(G6)、VSX Extension 同步(G7)、文档更新提醒(G8)与 git 状态检查(G9)。Paper Hooks 在检测到论文文件变更时启用,覆盖引用完整性(P1)、AI 痕迹用词扫描(P2)、concept 对齐(P3)、字数检查(P4)、受保护内容(P5)、记忆同步(P6)、文献元数据完整性(P7)与方法学可复现性(P8)。

使用方式:默认按 Step 0 检测变更范围(get_changed_files 或 git diff --cached --name-only),论文文件匹配模式为 projects//drafts/ 等,再按模式执行。标准模式执行 Step 0 → G1-G7 → P1-P8(如适用);快速模式执行 G1 + P1 + P5;开发模式执行 G1-G7 并跳过 Paper Hooks。Commit Message 格式为 type(scope): description,type 可选 feat、fix、docs、refactor、style、test、chore。

适用场景:论文草稿、concept、参考文献与项目文档的提交前把关;也可用于代码提交前的项目一致性与架构检查。

限制:Pre-Commit Hooks 只报告不自动修改(记忆同步 P6 例外为 AUTO-FIX);P2 的 AI 痕跡扫描依赖 Agent 判断;Hook 效能统计写入 projects/{slug}/.audit/precommit-stats.md,可能出现过松或过严的提示。部分 Hook 依赖对应 MCP 工具与 Skill,具体清单以资料为准。