From dff8ba87aa9e3af2dfa07dd6dadf0314cb228df0 Mon Sep 17 00:00:00 2001 From: bestony <13283837+bestony@users.noreply.github.com> Date: Sat, 21 Feb 2026 05:55:25 +0000 Subject: [PATCH 1/2] feat(backlog): add backlog-pr-issue-auto-labeling requirement --- ...21055525-backlog-pr-issue-auto-labeling.md | 59 +++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 backlog/20260221055525-backlog-pr-issue-auto-labeling.md diff --git a/backlog/20260221055525-backlog-pr-issue-auto-labeling.md b/backlog/20260221055525-backlog-pr-issue-auto-labeling.md new file mode 100644 index 0000000..3ec8eab --- /dev/null +++ b/backlog/20260221055525-backlog-pr-issue-auto-labeling.md @@ -0,0 +1,59 @@ +--- +source: backlog-discovery +dedupe_key: backlog-pr-issue-auto-labeling +priority: P2 +generated_at: 2026-02-21T05:53:53Z +status: TODO +--- + + + +# Requirement: 为自驱生成的 Issue/PR 增加自动标签与优先级同步 + +## 1. Requirement Summary +- Backlog Discovery 与 Product Designer 等流程会自动创建 Issue/PR，但当前仓库缺少统一的标签与优先级映射机制，导致维护者无法快速筛选高优先级项或按类型分流，需求评审与执行排期效率降低。 + +## 2. Target Users +- 仓库维护者 +- 产品负责人 +- 自动化值班人员 + +## 3. Core Scenarios +- Backlog Discovery 自动创建 PR 后没有 priority/type 标签，维护者难以在 PR 列表中快速区分 P1/P2。 +- Product Designer 自动创建的需求 Issue 未标注来源类型与优先级，导致与人工 Issue 混杂，难以聚合跟踪。 +- 需要在 GitHub 界面或 Projects 中按优先级/类型过滤自驱产出的工作项，但缺少可用的标签体系。 + +## 4. User Problems +- Backlog Discovery 与 Product Designer 等流程会自动创建 Issue/PR，但当前仓库缺少统一的标签与优先级映射机制，导致维护者无法快速筛选高优先级项或按类型分流，需求评审与执行排期效率降低。 + +## 5. External Research Evidence +1. GitHub Docs - Managing labels + - URL: https://docs.github.com/articles/editing-a-label + - 摘要: GitHub 官方文档说明可用 labels 来分类与管理 issues、pull requests，并支持创建、应用与维护标签体系。 +2. GitHub Docs - REST API endpoints for labels + - URL: https://docs.github.com/rest/issues/labels + - 摘要: GitHub 提供 labels 的 REST API，可用于自动化创建、查询与更新 Issue/PR 标签。 +3. GitHub Actions - actions/labeler + - URL: https://github.com/actions/labeler + - 摘要: actions/labeler 提供基于配置规则自动为 PR 添加标签的能力，体现社区对自动标签分流的需求。 + +## 6. Proposed Solution Hypothesis +- 新增 label 规范与自动化：在 Backlog Discovery / Product / Engineer 工作流中调用 GitHub API 或 labeler action，根据候选 priority 与来源类型自动打标。 + +## 7. Priority & Impact +- Priority: P2 +- Impact: 提升自驱产出需求的可见性与筛选效率，减少维护者在 PR/Issue 列表中的人工分流成本。 + +## 8. Acceptance Criteria +1. 定义并维护一套固定标签体系（例如 priority:P0~P3、type:backlog/type:plan），并在 workflow 中自动校验或创建缺失标签。 +2. 当 Backlog Discovery 创建 PR 时，自动按候选项 priority 与类型映射添加标签，并在 PR body/summary 中写入已应用标签。 +3. 当 Product Designer/Engineer 创建或更新 Issue/PR 时，自动同步或更新 priority/type 标签，且支持配置开关。 + +## 9. Metadata +- generated_at: 2026-02-21T05:53:53Z +- dedupe_key: backlog-pr-issue-auto-labeling +- english_desc: backlog-pr-issue-auto-labeling +- source_workflow: Backlog Discovery +- source_repository: bestony/self +- source_run_id: 22251460467 +- source_run_attempt: 1 From 2d94730ab3a4bfd73914414ef2c268f0a602b00d Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 21 Feb 2026 05:57:52 +0000 Subject: [PATCH 2/2] chore(backlog): refine requirement from trusted review feedback --- .../20260221055525-backlog-pr-issue-auto-labeling.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/backlog/20260221055525-backlog-pr-issue-auto-labeling.md b/backlog/20260221055525-backlog-pr-issue-auto-labeling.md index 3ec8eab..c3aae82 100644 --- a/backlog/20260221055525-backlog-pr-issue-auto-labeling.md +++ b/backlog/20260221055525-backlog-pr-issue-auto-labeling.md @@ -39,15 +39,19 @@ status: TODO ## 6. Proposed Solution Hypothesis - 新增 label 规范与自动化：在 Backlog Discovery / Product / Engineer 工作流中调用 GitHub API 或 labeler action，根据候选 priority 与来源类型自动打标。 +- 先收敛最小可用标签集（priority + type），明确默认开关策略（默认开启或需显式 opt-in），再逐步扩展。 +- 上线前补充仓库内证据：采样当前 PR/Issue 分流耗时或误判率，作为基线以验证效果。 ## 7. Priority & Impact - Priority: P2 - Impact: 提升自驱产出需求的可见性与筛选效率，减少维护者在 PR/Issue 列表中的人工分流成本。 ## 8. Acceptance Criteria -1. 定义并维护一套固定标签体系（例如 priority:P0~P3、type:backlog/type:plan），并在 workflow 中自动校验或创建缺失标签。 -2. 当 Backlog Discovery 创建 PR 时，自动按候选项 priority 与类型映射添加标签，并在 PR body/summary 中写入已应用标签。 -3. 当 Product Designer/Engineer 创建或更新 Issue/PR 时，自动同步或更新 priority/type 标签，且支持配置开关。 +1. 定义并维护一套最小可用标签体系（例如 priority:P0~P3、type:backlog/type:plan），并在 workflow 中自动校验或创建缺失标签。 +2. 明确标签同步开关的默认策略（默认开启或 opt-in），并支持按工作流配置覆盖。 +3. 当 Backlog Discovery 创建 PR 时，自动按候选项 priority 与类型映射添加标签，并在 PR body/summary 中写入已应用标签。 +4. 当 Product Designer/Engineer 创建或更新 Issue/PR 时，自动同步或更新 priority/type 标签，且支持配置开关。 +5. 上线前记录至少一项仓库内基线指标（例如分流耗时或误判率），用于验证自动标签的改进效果。 ## 9. Metadata - generated_at: 2026-02-21T05:53:53Z