用途:在 Git 仓库根目录的 docs/backlog/ 中维护延迟工作项,每个条目一个文件,路径固定,便于每次调用读写同一存储。仅适用于 Git;不在 Git 仓库中应直接说明并停止,不迁移到其他版本控制。
条目格式:docs/backlog/<slug>.md,slug 命名缺陷而非所在文件。frontmatter 含三个字段:worth(yes/later/no,列表按此排序)、where(path:line,可省略)、added(YYYY-MM-DD,不更新,零填充)。H1 为标题,正文无必需章节。later 必须写明待定的未知或条件;no 需记录拒绝理由以防重复发现。
生命周期:工作落地时在修复提交中 git rm 该文件,无复选框或进行中标记;放弃条目同理。
使用方式:/workflow:backlog --all 逐条走查所有条目,先验证 where、分析价值与阻塞,再逐条打印简报(摘要、工作量、影响范围、重要性)并用 AskUserQuestion 询问处置,推荐项在前,逐条执行后再问下一条,编号显示进度。带 slug 参数则只处理该条目,跳过列表。读取列表时 glob docs/backlog/*.md,按 yes、later、no 排序报告,每项一行。
追加:运行产生延迟项时先询问再写入,绝不静默写入。写入前检查分支:读取 git symbolic-ref refs/remotes/origin/HEAD 并去掉前缀,失败则依次尝试 refs/remotes/origin/master、main、trunk,再试本地 refs/heads/master、main、trunk;与 git branch --show-current 比较。非默认分支需询问是否就地写入。写入前去重,按缺陷本身判断而非仅路径。创建目录须在分支检查之后。提交前读取 git diff --cached --name-only,索引非空则不提交;为空时用 AskUserQuestion 询问,只暂存本次创建或编辑的确切路径,可一并提供提交与推送。
限制:不得自动提交,不得将条目与无关工作一起提交,不得未经要求修复条目,不得将条目发到 PR/MR/issue,除非用户明确要求。无用户可见症状时应如实说明,不夸大。资料未提供具体安装命令、收费或平台信息。