SuperAPI AI 工具集

pflow-backlog

通用与其它

查看项目

更新于 10-15 21:35

技能介绍

用途:管理项目 backlog。它把待办任务写成 docs/backlog 下编号命名的 Markdown 文件(<NNN>-<slug>.md),任务完成或转入 spec 后删除对应文件。

主要能力:新增任务与删除任务。新增通过脚本 backlog-add.sh 完成,删除通过 backlog-remove.sh 完成。状态是隐式的:文件存在即为新建待办,删除即表示关闭;不保留历史。脚本在目录不存在时会创建 docs/backlog,并从现有最高编号文件取下一个编号,因此只有该文件存在期间编号才保持连续。

使用方式:先澄清要记录什么以及原因,需求含糊时必须询问,不要假设。任务正文用面向人的纯文本,使用项目文档语言(依据 AGENTS.md/CLAUDE.md 或现有文档,否则用对话语言),不写标题、frontmatter、状态、列表或强调,最多 10 行非空内容,每行最多 140 字符,过长需换行。然后自拟不超过 100 字符的拉丁 kebab-case slug,执行: .agents/skills/pflow-backlog/scripts/backlog-add.sh --slug "SLUG" <<'PFLOW_BACKLOG_EOF' <task text> PFLOW_BACKLOG_EOF 返回 {status,path,number,slug,lines,width},回复 ✅ Backlog: <path>。关闭或提升时执行: .agents/skills/pflow-backlog/scripts/backlog-remove.sh --name "<NNN-slug>"(或 --name "<slug>"),返回 {status,removed,number}。

错误处理与限制:脚本失败(非零退出或 JSON 中 status 为 error)时输出 ⚠️ <error.message> 并停止;但 backlog-add.sh 的 slug 错误例外,可另拟 slug 重试,最多 3 次。写 backlog 文件时需遵循 pflow-docs。任务转入 spec 时应在同一步删除 backlog 文件,不要两者并存。其他平台支持、安装方式与收费信息暂未提供。