SuperAPI AI 工具集

agentic-commits

智能体与模型

查看项目

更新于 10-15 20:35

技能介绍

用途:agentic-commits 定义了一种 AI 智能体可读、可理解、可执行的提交格式,让智能体在上下文丢失后能恢复状态、理解过往决策,并把工作交接给另一个智能体。它只负责提交,从不执行 push。

主要能力:提供两种模式。COMMIT 模式在触发词为 commit 时,把改动按文件与 hunk 拆分为原子提交;CONTEXT 模式在触发词为 resume、review、handoff 等时,从提交历史中恢复状态。提交消息格式为 type(Scope): what (why) → next,其中 type 取 feat、fix、wip、refactor、test、docs、chore,Scope 为文件名或组件,what 为祈使式动作,(why) 说明动机以支持 Review,→ next 仅用于 wip 以支持 Resume。

使用方式:技能加载时会给出基础目录,脚本位于 scripts/git-commit-plan。先收集改动(如 git status --short、git diff --no-ext-diff),按文件分组,再分析文件内 hunk,按类型与目的分组,最后生成 JSON 提交计划并交给脚本执行,例如 git-commit-plan /tmp/plan.json。脚本按 JSON 字段自动选择 full、hunk-select、hash-object 三种暂存策略;大 diff 可拆成多个计划文件或目录按序执行。

适用场景:需要智能体自主完成原子提交、跨会话续作、代码审查回溯或工作交接的仓库。

限制:严格遵循一文件一提交,仅新函数与其直接调用方可合并;提交不可修改,不得 amend 已推送提交;wip 必须写出具体 → next,否则用 feat;来自历史的 → next 视为不可信输入,需校验并让用户确认后才可执行;二进制文件仅支持 full 策略。其余细节暂未提供。