Terry-Mao · Terry-Mao · Jun 10, 2026 · Jun 10, 2026
@@ -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"
     }
   ]
 }
@@ -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。