SuperAPI AI 工具集

pflow-commit

编程与开发

查看项目

更新于 10-16 03:41

技能介绍

用途:pflow-commit 用于在项目工作区中分析未提交改动,撰写一行符合 Conventional Commits 规范的提交信息,并执行提交与推送。资料明确说明它只被手动调用。

主要能力与用法:先判断上下文来源。若本次会话已覆盖全部未提交改动、且清楚每个改动文件及其内容,可跳过脚本直接撰写信息;否则运行 .agents/skills/pflow-commit/scripts/git-commit-context.sh,若输出为 No changes detected. 则告知用户无可提交内容并停止。随后仅依据该上下文来源撰写 MESSAGE,再以升级执行模式运行 .agents/skills/pflow-commit/scripts/git-commit-push.sh --message "MESSAGE",以获取 .git 写权限。脚本成功时输出 JSON:{commit_hash, branch_name, push_status, message};失败时含 error:{step, message},此时应打印 ⚠️ <error.message> 并停止。成功后按脚本返回的实际内容回复提交信息、哈希、分支与推送状态。

提交信息格式:单行 <type>[(scope)][!]: <description>,理想长度不超过 72 字符,无正文、无 footer、无 trailer。类型包括 feat、fix、build、chore、ci、docs、style、refactor、perf、test、revert;破坏性变更用 ! 表示。语言必须为英文,除非用户明确要求其他语言;描述使用祈使语气。

限制:git-commit-push.sh 执行 git add -A,会提交工作区全部改动,而非仅信息中描述的部分;提交永远只保留 --message 的第一行非空内容,其余正文与 trailer 均被丢弃。脚本会预检 .git 写权限与过期的 index.lock。步骤一来源是唯一输入,不得读取文件、执行 git 命令、搜索或调用子代理来补充或验证;上下文不完整时只能描述可见部分,且不得向用户追问更多上下文。脚本输出有截断(每文件最多 50 行、总计 600 行),不能对截断部分下结论。push_status 为 pushed 或 pushed_with_upstream。其他平台支持、收费与价格信息暂未提供。