SuperAPI AI 工具集

backlog

办公与效率

查看项目

更新于 10-15 10:26

技能介绍

用途

backlog 是 keel 的暂缓任务池,用于记录已经有来源编号、暂时不进入当前开发闭环、但未来需要追溯的项。它只维护 docs/devdocs/backlog.md 这一集中索引,不创建新编号体系,也不修改原编号文件。条目通过 source_id + entry_no 做局部锚点,允许同一来源产生多条暂缓项。

边界方面,它区分于 PO grooming:不做产品排序、价值评审、负责人分配;区分于 Jira / Linear:不维护看板、泳道、Sprint 容量;区分于 04-dev-tasks.md:不表示当前已排期任务,只表示暂缓且可追溯。

主要能力

CLI 入口包括:

/backlog --park <source_id>       # 写入 parked 条目
/backlog --reactivate <source_id> # parked → reactivated
/backlog --close <source_id>      # parked → closed
/backlog --supersede <source_id>  # parked → superseded(可选)
/backlog --list[=status]          # 列出条目,默认全部
/backlog --init                   # 初始化 docs/devdocs/backlog.md(使用 templates/backlog-template.md)

编排入口:/pipeline backlog 路由到本 skill,传入 skill: backlog、mode: read | dry-run | apply,inputs 含 command 与 source_id,expected_output 为 yaml-summary-v1。

触发词:暂缓、任务暂缓、先记下、暂时不做、回到 backlog、backlog 管理、backlog entry、park、reactivate。

使用方式

docs/devdocs/backlog.md 是唯一 SSOT,状态只在该文件维护,原 F/US/AC/T/INS/BUG/FR/NFR 文件不加状态字段。文件包含 frontmatter、Index(按 status 分组)、Entries(每条一个块,标题推荐 ### F-01#1 - <短标题>)、可选 Change Log。

条目必填字段:source_id、entry_no、status、created_at、created_by_skill。状态条件字段:reactivated 需 target_flow / target_id;closed 需 reason;superseded 需 superseded_by。可选字段:note、related_ids、created_from、updated_at、updated_by_skill、decision_log。其中 source_id 复用已有编号(F-XX / US-XX / AC-XX / T-XX / INS-XX / BUG-XX / FR-XX / NFR-XX / M-XXX),禁止 B-XXX;M-XXX 是唯一允许承接「尚无任何编号」来源的例外。

状态机:初始状态只能是 parked;parked 可转为 reactivated(需 target_flow + target_id)、closed(需 reason)、superseded(需 superseded_by);后三者为终态。禁止 done 状态,完成度由目标流程自身记录。

生产侧衔接上,其他 skill 产生「暂缓不阻塞」项时,优先通过 yaml-summary-v1 向编排层声明,编排层再调用 backlog --park 写入。候选项最小结构示例:

summary:
  details:
    backlog_candidates:
      - source_id: AC-05
        note: "P3 边界 case 待优化"
        created_by_skill: verify
        related_ids: [F-01, AC-07]

触发场景包括 dev-tasks(任务暂缓、依赖未就绪等)、verify(P3 问题自动入池,P1/P2 不直接 parked)、insights(跨任务优化机会)、prd(FR/NFR 搁置)、dev-workflow(里程碑段内新想法,source_id = 当前 M-XXX)。

消费侧转化路径按 source_id 类型路由:F-XX / US-XX / AC-XX → requirements;T-XX → dev-tasks;INS-XX → insights;BUG-XX → bugfix;FR-XX / NFR-XX → prd;M-XXX 无固定去向,按条目形态定。reactivate 必须写回 target_flow 和 target_id;若目标流程尚未生成编号,保持 parked 并返回 partial。

门控与限制

--reactivate 缺少 target_flow 或 target_id 时禁止继续;--close 缺少 reason 时禁止继续;尝试创建 B-XXX 或新编号体系时禁止继续;同一 source_id 已有 active parked 条目时再次入池需用户确认(M-XXX 来源例外,默认追加新 entry_no)。

该技能不维护负责人、优先级看板、泳道、Sprint 容量;不替代 Jira / Linear / GitHub Issues;不新增 B-XXX 或任何 backlog 专属编号;不修改原 F/US/AC/T/INS/BUG/FR/NFR 文件;不把 reactivated 解释为完成,也不提供 done 状态;不自动改 pipeline / dev-tasks / verify / insights / prd,仅声明后续集成契约。

模板与 realign:初始化模板为 templates/backlog-template.md,结构演进见 references/realign.md,backlog.v2 是当前 spec 版本。子 Agent 摘要格式采用 yaml-summary-v1 envelope,私有字段含 mode、backlog_path、entries_added / entries_updated、status_counts、affected_entries、target_flow / target_id、pending_confirmation;产物 output_files 仅列出 docs/devdocs/backlog.md,new_ids.backlog_entries 记录局部锚点。

适用场景

适用于在 keel 工作流中管理暂缓但需追踪的事项,例如记录先记下、暂时不做、回到 backlog 的工具条。