SuperAPI AI 工具集

pflow-task-finish

通用与其它

查看项目

更新于 10-16 03:41

技能介绍

用途:关闭当前 mdtodo 任务。若已安装 pflow-commit,则进一步为工作内容创建分支、提交并合并到 dev 分支。该技能仅支持手动调用。

主要能力与用法:先按 Conventional Commits 格式编写单行 MESSAGE,可运行只读脚本 .agents/skills/pflow-commit/scripts/git-commit-context.sh 依据 diff 生成提交信息;若该脚本报告无改动、执行失败,或因未安装 pflow-commit 而缺失,则使用类似 chore: finish task <title> 的最小信息。随后执行一次:.agents/skills/pflow-task-finish/scripts/task-finish.sh --message "MESSAGE" [--slug "SLUG"] [--dev "BRANCH"]。脚本输出一行 JSON,按 status 处理:no_current_task 表示无任务可收尾;closed_no_git 表示任务已关闭但跳过 git,并提示安装 pflow-commit;finished 则报告任务、分支合并、提交与推送、清理结果。

提交信息要求:单行,尽量不超过 72 字符,无正文、无 footer/trailer(如 Co-Authored-By、Signed-off-by),脚本会丢弃首行之后的内容;语言必须为英文,除非用户明确要求其他语言。类型包括 feat、fix、build、chore、ci、docs、style、refactor、perf、test、revert;破坏性变更在冒号前加 !。

限制与注意:git add -A 会包含全部工作区改动,而非仅任务 markdown;从非 dev 分支运行时提交并合并该分支且忽略 --slug,只有直接从 dev 分支收尾时才创建 task/<slug>;合并冲突会停留在 dev 分支的合并中间状态需手动解决;合并成功后尽力删除本地与远程任务分支,失败会体现在状态字段但不导致任务失败;直接在 dev 分支收尾时不删除分支。