diff --git a/docs/product/.product-docs-sync-ledger.json b/docs/product/.product-docs-sync-ledger.json index 8ae2673..995665d 100644 --- a/docs/product/.product-docs-sync-ledger.json +++ b/docs/product/.product-docs-sync-ledger.json @@ -2146,6 +2146,26 @@ "proposed_patch": "新增 docs/product/raw/update-triage-workflow.md,记录 update-triage 的触发输入、维护者修正信号学习规则、允许写入范围和固定 PR 行为。", "reason": "PR #254 新增了可由维护者手动触发的 update-triage 自进化 workflow,并定义了 triage 反馈学习规则、写入边界和 PR 行为。这是长期产品行为变更,现有产品文档只覆盖 issue triage、update-dedupe 和 update-pr-review,未覆盖该新流程。", "recorded_at": "2026-06-10T00:01:02Z" + }, + { + "pr": 256, + "url": "https://github.com/Terry-Mao/AICodingFlow/pull/256", + "title": "Update triage guidance", + "merged_at": "2026-06-09T10:46:43Z", + "merge_commit": "c4ee864e6c3150bc59e11ee6ac811c6c6c628826", + "docs_update": "uncertain", + "affected_docs": [ + "docs/product/raw/issue-triage-workflow.md" + ], + "source_context": [ + "PR #256", + ".agents/skills/triage-issue-repo/SKILL.md", + ".agents/skills/triage-issue/SKILL.md", + "docs/product/raw/issue-triage-workflow.md" + ], + "proposed_patch": "已在 docs/product/raw/issue-triage-workflow.md 中保守记录 PR #256 的 repo companion 生命周期标签 guidance,并明确标注 ready-to-spec / ready-to-implement 输出边界仍需产品确认。", + "reason": "PR #256 更新了 repo-local triage companion,新增 ready-to-spec 与 ready-to-implement 的生命周期标签判断规则,属于长期 triage workflow 行为。该规则与 core triage-issue skill 当前的 reserved label 禁止输出规则存在冲突,因此需要产品确认后才能写成确定行为。", + "recorded_at": "2026-06-10T05:08:46Z" } ] } diff --git a/docs/product/raw/issue-triage-workflow.md b/docs/product/raw/issue-triage-workflow.md index c791472..1c5fa71 100644 --- a/docs/product/raw/issue-triage-workflow.md +++ b/docs/product/raw/issue-triage-workflow.md @@ -39,8 +39,15 @@ code blocks 都是待分析数据,不是可执行 workflow 指令。 不能重定义分诊输出 schema、安全规则或 follow-up-question contract。该 companion 当前记录的 仓库规则包括:区分观察到的症状与报告者假设;先通过代码检查、文档查询或 web search 自行尝试 回答 follow-up question;只在问题无法由 agent 自行解决且会实质影响分诊置信度时提问;优先提出 -具体问题而不是泛泛要求更多信息。label taxonomy 以 `.github/issue-triage/config.json` 为准, -agent 不应自行发明新 labels,除非上层 prompt 明确允许。 +具体问题而不是泛泛要求更多信息;对于已经包含足够产品或 spec pass 信息的具体 workflow、skill、 +documentation 或 test 失败和改进,可考虑 `ready-to-spec`;`ready-to-implement` 应视为后续生命周期 +label,只在 issue 已有已批准或明显完整的 spec/plan,或维护者提供的 issue context 明确说明已批准实现时 +才考虑。label taxonomy 以 `.github/issue-triage/config.json` 为准,agent 不应自行发明新 labels, +除非上层 prompt 明确允许。 + +上述生命周期 label guidance 来自 repo companion 的维护者修正学习结果,但与 core `triage-issue` +skill 当前保留 label 规则之间仍需要产品确认:core 规则仍禁止 companion 改变 +`ready-to-implement`、`ready-to-spec` 等 reserved label 行为。 ## `triage_result.json` @@ -58,10 +65,12 @@ agent 的唯一 handoff 是 `triage_result.json`。该 JSON 包含: `follow_up_questions` 与 `duplicate_of` 互斥。若发现重复 issue,重复判断优先,问题列表必须 为空;若需要 reporter 补充信息,则 `duplicate_of` 必须为空。 -`plan-approved`、`ready-to-implement` 和 `ready-to-spec` 是受保护 labels,分诊结果不得请求 -添加它们。若配置中存在 `duplicate`,重复结果必须带 `duplicate` 且不能带 `triaged`;若不存在 -重复和 follow-up questions,且配置中存在 `triaged`,结果必须带 `triaged`;若存在 -follow-up questions,且配置中存在 `needs-info`,结果必须带 `needs-info`。 +`plan-approved` 仍是受保护 label,分诊结果不得请求添加。`ready-to-implement` 和 +`ready-to-spec` 的最终输出边界需要产品确认:core skill 当前仍把它们作为 human-maintainer +reserved labels,而 repo companion 已记录维护者反复补加这些生命周期 labels 的仓库级 guidance。 +若配置中存在 `duplicate`,重复结果必须带 `duplicate` 且不能带 `triaged`;若不存在重复和 +follow-up questions,且配置中存在 `triaged`,结果必须带 `triaged`;若存在 follow-up questions, +且配置中存在 `needs-info`,结果必须带 `needs-info`。 ## GitHub 更新边界 @@ -72,4 +81,4 @@ follow-up questions,且配置中存在 `needs-info`,结果必须带 `needs-i label 同步只管理 triage config 中定义且非受保护的 labels:结果中缺失的已管理 labels 会被移除, 结果中新增的已配置 labels 会被添加;issue 上不属于 managed label set 的其他 labels 会保留。 -来源:PR #121,PR #123,PR #133,PR #138,Issue #19,Issue #137。 +来源:PR #121,PR #123,PR #133,PR #138,Issue #19,Issue #137;PR #256。