agile-backlog

当用户说"写待办""拆任务""Backlog""Product Backlog""使能项""优先级排序""排迭代"或 using-agile 路由到此,且战略层(VISION + ARCHITECTURE/ADR)已确认时触发。

SKILL.md

GitHub

产品待办 (Agile Backlog)

0. 前置条件(缺失则路由回退)

条件 缺失时路由
agile-docs/ 目录存在 → using-agile 初始化
agile-docs/VISION.md 存在 → agile-strategic 阶段 A
agile-docs/ARCHITECTURE.md + ADR.md 存在 → agile-strategic 阶段 B(用户明确跳层时可缺,T-NNN 由门禁 ① 拦截)

1. 定位

本技能是执行层中枢,产出单一文件:agile-docs/PRODUCT-BACKLOG.md——人读与 Agent 共读同一份。阶段表即机器接口(列名固定契约,见 references/backlog-rules.md §七),消费 Agent 读表拿排序和状态,按 id 回读「任务详情」段取详情。

它是待办池(to-do list)。技术任务(T-NNN)和功能需求(F-NNN)平级进入待办池。不强制 INVEST/Given-When-Then 仪式。

产出分阶段,每阶段写完即停(不再一次性出全部):

阶段 产出 前置
阶段 0 (无文件)决策问询 读 VISION/ADR + 项目画像
阶段 1 阶段表 + 估点建议(§3 阶段 1,阶段表即唯一结构,多阶段分组同步落同一 .md) 阶段 0 完成
阶段 2 任务详情展开 + 验收标准(§3 阶段 2) 阶段 1 确认
阶段 3 下游影响评估(§3 阶段 3,仅更新已有 Backlog 时) 阶段 2 确认
阶段 4 接受 .done 同步(§3 阶段 4,仅 .done.yaml 回传时) .done.yaml 存在(入口闭环路由;Sprint 未关闭时先经 agile-sprint 关闭)

决策用选择题问(using-agile/references/interview-protocol.md):先读 VISION/ADR 补事实(文档优先),只把真决策(范围/优先级/估点/验收)用「候选 + 推荐 + 自定义」一次一问地喂给用户。变更时先分级(using-agile/references/change-matrix.md §二),禁止整层重访。

2. 写前对齐(先问询,再产出)

2a. agent 自检 checklist(机械项,不需用户参与)

  • 用 VISION 的"核心原则 / 战略红线"校验每个条目的归属(不服务愿景的不进 Backlog)
  • 用 ADR.md 中的决策推导技术任务(T-NNN),每条 T-NNN 关联对应 ADR 章节
  • 确认优先级排序逻辑(见 references/backlog-rules.md)
  • 旧格式迁移检测:若 agile-docs/ 下存在旧接口文件 PRODUCT-BACKLOG.yaml 或 PRODUCT-BACKLOG.json(v4.x 及之前的双文件格式)→ 把其中仅机器侧持有的信息(adr_refs / confirmed / withdrawn)核对进阶段表对应列(关联 / 已确认 / 状态),删除旧文件后再继续
  • 全量统计(取代增量手算):改动条目后从阶段表重新全量统计——总条目 / 总点数 / 按优先级分组 / 按状态分组 / ADR 关联覆盖。覆盖式重算,禁止在旧统计数字上增量加减

2b. 决策问询(写前必跑,using-agile/references/interview-protocol.md)

按 using-agile/references/interview-protocol.md 用选择题问,本技能落点:

  1. 需求探索(新增需求场景必跑;更新已有 Backlog 按 change-matrix.md 分级,L2 只重问受影响项)

    先读 VISION/ADR/项目画像补事实(文档优先),自检六项 checklist(机械项不需用户参与)——每项能查则查、查不到用选择题问,缺项标 {待确认} 不许脑补:

    # 探索项 查 / 问
    1 背景与目标:解决什么问题 VISION 原则/画像可解释 → 查;否则问
    2 用户与使用场景:谁用、何时触发 现有条目可推断 → 查;否则问
    3 验收行为:交付后可观察的行为 必问——给 2-3 版候选写法供选(这是后续决策点 3 的素材)
    4 边界与不做:显式排除范围 从目标反推候选 → 确认;不明确 → 问
    5 优先级信号:Must 依据 给 Must/Should 建议 + 依据(业务价值/依赖/风险)→ 确认
    6 关联约束:依赖其他条目/外部系统 grep 现有 Backlog + ADR → 列候选确认

    探索确认 → 进入决策问询。

  2. 文档优先:读 agile-docs/VISION.md(原则/红线)、ADR.md、DOD.md 头部项目画像;VISION 已确认的定位/原则不重问,只问待办层缺口。

  3. 一次一问 + 给推荐:三个决策点逐个问(候选 + 推荐 + 自定义兜底),答完再问下一个:

# 决策点 候选选项方向(结合实际填,给推荐 + 理由) 追问触发 兜底
1 MVP 范围 对每个 Must 条目给「保留 / 降为 Should / 降为 Could」选项 + 推荐 答不出"不做首版会怎样" → 推荐降级;Must 占比 >60% 时质疑"全都 Must 等于没有优先级" 用户"你看着办" → 按推荐降级,标 agent 推荐
2 估点 agent 给建议值 + 一句理由,给「接受 / 调整」选项 点数 ≥5 或复杂度存疑 → 给复杂度信号选项(涉及几个模块?外部依赖?) 用户"你看着办"→ 按建议值 + 标"agent 推荐"
3 验收 "非显然"条目给 2-3 版可观察行为的验收写法供选(素材来自需求探索③) 答不出 → 继续追问,不许自行脑补 用户明确跳过 → 验收栏标 {待确认}
  1. 共识后落盘:三决策点确认 → 进入 §3 产出;未确认不写 Backlog 文件。

变更快速响应:已产出后遇「需求变了」,先按 using-agile/references/change-matrix.md §二 分级——L1 措辞就地改、L2 只重问受影响条目、L3 才走完整问询;L1/L2 禁止整层重访。

3. 产出(分阶段,每阶段写完即停)

阶段 1:阶段表 + 估点建议(先出排序,不展开详情)

阶段表即唯一结构——PRODUCT-BACKLOG.md 不再单独维护"优先级排序表"。条目按"阶段 N"分块(如 ## 阶段 1 / ## 阶段 2),所有阶段共用同一 .md 文件。禁止制造"池表 + 阶段表"双轨结构——任何"待办池"只是各阶段表的并集,不单独立表。

先写 PRODUCT-BACKLOG.md 的「阶段表」段(列名固定:id/标题/类型/仓库/点/优先级/状态/关联/来源/已确认,契约见 references/backlog-rules.md §七),暂不写「任务详情」段。写完停,结构化审阅后再进阶段 2。

# Product Backlog

> 维护说明:条目按"阶段 N"分块排序。技术任务与功能需求平级。改完重新全量统计。

## 阶段 1

| ID | 标题 | 类型 | 仓库 | 点 | 优先级 | 状态 | 关联 | 来源/依据 | 已确认 |
|----|------|------|------|---|--------|------|------|-----------|--------|
| T-001 | {标题} | 技术 | api-server | 5 | Must | 待办 | ADR-001/005 | 用户确认 / 依赖优先 | ✓ |
| F-001 | {标题} | 功能 | — | 2 | Must | 待办 | — | agent 推荐 / MoSCoW | 待确认 |
...
  • 「来源/依据」列承载两个标注:点的来源(agent 推荐 或 用户确认)+ 优先级依据(开发顺序 / MoSCoW / 依赖 / ADR 优先级,见 references/backlog-rules.md §三)。
  • 「仓库」列仅多仓库项目填写(条目标注归属仓库,供 Sprint 规划识别跨仓库交接点,见 references/backlog-rules.md §二);单仓库项目可省略该列。
  • 「已确认」列:优先级 / 点数 / 验收已与用户确认 → ✓;agent 推荐待确认 → 待确认;Sprint 取用前必须把 待确认 行显式转 ✓(否则 agile-sprint 跳过该条目并告警)。
  • 改完重新全量统计(§2a,覆盖式重算,禁止增量口算)。

阶段 2:任务详情展开 + 验收标准(仅非显然条目)

在 PRODUCT-BACKLOG.md 追加「任务详情」段,仅非显然条目展开(验收/约束/关联),判定标准见 references/backlog-rules.md §四。写完停,结构化审阅后再进阶段 3。

## 任务详情(仅非显然条目展开)

### F-NNN {标题}
- 验收: {1-3 条可观察行为}(来源:{用户给出 / 待确认})
- 关联: {ADR 或其他条目}

### T-NNN {标题}
- 要求: {1-3 条约束}
- 关联: {ADR}
  • 验收写不出可观察行为 → 回决策问询追问(§2b 决策点 3),不许脑补;用户明确跳过 → 标 {待确认}。

阶段 3:下游影响评估(更新已有 Backlog 时的审阅清单项)

首次产出跳过;本次若是「更新已有 Backlog」,作为结构化审阅清单的一项评估下游 Sprint 是否需要改变(using-agile/references/change-matrix.md §四),不单独成环节:

  • 本次变更是否涉及「活跃 Sprint 已引用的条目」的点数 / 优先级 / 状态 / 删除?
    • 是 → 评估承诺点是否仍 ≤ 可用点、任务清单是否需换入/换出;给调整建议,由用户裁决是否触发 agile-sprint 重规划。
    • 否 → 审阅清单记「下游无影响」。
  • 增删条目 → 检查活跃 Sprint 任务清单是否受影响。

阶段 4:接受 .done 同步

当 using-agile 检测到 sprints/*.done.yaml(默认执行回填闭环)并路由到本技能:

  1. 读取 .done.yaml,按 completed / moved_next 批量更新 PRODUCT-BACKLOG.md 阶段表「状态」列
    • completed 条目 → 状态: "已完成"
    • moved_next 条目 → 状态: "待办",仅改状态,优先级列保持原值不动(原属顶部条目,状态复位后自然回到取用顺序前列;禁止为"保回顶部"擅自调高优先级)
  2. 处理 feedback(.done.yaml 的 feedback 列表):
    • reason(未完成原因)→ 已由 agile-sprint 在关闭环节展示,此处无需处理
    • issue(执行中发现的新问题)→ 转为 Backlog 新条目候选:列出建议条目(标题 / 类型 / 优先级建议 / 来源标注"消费 Agent 反馈"),请用户确认后新增进阶段表
    • decision(需产品层裁决)→ 停下请用户裁决;裁决结果落盘为条目或明确忽略
  3. 将 .done.yaml 文件后缀改为 .done.processed.yaml(留痕,不删除)
  4. 完成后停下,报告同步结果 + 反馈处理结果

4. 写完即停(结构化审阅,每阶段都走)

每个产出阶段写完即停,按 using-agile/references/probing-protocol.md §四 输出决策点确认清单(重点列排序依据 / 优先级判断 / agent 自估点数及理由 × 来源;阶段 3 追加「下游影响评估」结论),问"继续下一阶段 / 下一步(agile-sprint)还是更新本层?"。

5. 硬约束

  • ✅ 产出 PRODUCT-BACKLOG.md 单文件(人读与 Agent 共读,阶段表即机器接口);❌ 不顺手写 VISION / ARCHITECTURE / ADR / Sprint;❌ 不另建任何机器侧副本文件(.yaml/.json 接口文件已废弃)。
  • ✅ 决策问询是产出前环节(§2b,口径见 using-agile/references/interview-protocol.md),决策点未确认不落盘。
  • ✅ 产出分阶段(排序+估点 → 详情+验收,§3),每阶段写完即停;❌ 禁止一次性出全部。
  • ✅ 阶段表即唯一结构——PRODUCT-BACKLOG.md 按 ## 阶段 N 分块落同一文件(§3 阶段 1),禁止单独维护"优先级排序表 / 待办池"等平级结构;列名严格固定(§七 机读契约),不自由增删改列名。
  • ✅ 技术任务(T-NNN)和功能需求(F-NNN)平级;仅"非显然"条目展开(§3 阶段2)。
  • ❌ 不使用 INVEST / Given-When-Then 仪式,不拆 epics/enablers 子目录,不用 US/EN/EPIC 命名。
  • ✅ 涉及架构决策的 T-NNN 必须关联 ADR(门禁 ①,判定细则见 using-agile/references/gate-protocol.md §二 ①)。
  • ✅ 关键决策落盘带来源标注(用户给出 / agent 推断 / agent 推荐待确认)。
  • ✅ Backlog 条目只写范围(可观察验收行为 / 业务与非功能约束 / 边界 / 依赖关联),❌ 不写实现(技术方案 / 框架选型 / 代码结构 / SQL / 伪代码)——技术决策由 ADR 承载,实现归消费 Agent 判断(细则见 references/backlog-rules.md §四)。
  • ✅ 全量统计取代增量手算:改动条目后从阶段表重新全量统计(§2a),禁止在旧数字上加减。
  • ✅ 未确认条目 Sprint 取用前必须显式 confirm:阶段表「已确认」列为 待确认 的「待办」条目,agile-sprint 取用时跳过并告警;不私自默认 ✓(agent 推荐 ≠ 用户确认)。

6. 门禁

  • T-NNN 无 ADR:技术任务涉及架构决策但未关联 ADR.md 章节 → 停下,先回 agile-strategic 阶段 B 补 ADR 章节,再回填关联字段。现有 ADR 无合适章节时同样回阶段 B 补,禁止发明"待 ADR-NNN 确认"之类的占位关联(判定细则见 using-agile/references/gate-protocol.md §二 ①)。
  • 条目过大无法估点:用拆分法降为多个 T-/F- 条目再估点(边界异常 ⑤)。
  • 冲突 / 歧义即停(见 using-agile/references/gate-protocol.md)。