---
name: notify-related-issue
description: 依實際 PR 與驗收狀態草擬關聯 Issue 更新，僅在明確授權留言或關閉時發布並回讀。
---

<!-- GENERATED by plugin/scripts/build.ts — 不要直接改這個檔案，改 plugin/skills/<name>/ 後重跑 pnpm plugin:build -->


# 更新關聯 Issue

先讀 [共用交接規則](../../docs/ai-human-review-workflow.md)。接受 PR URL／編號或當前分支，支援僅草稿；不得把一般開發授權當成發送留言的授權。

1. 使用 `gh pr view` 取得真實 repo、URL、body、state、mergedAt、baseRefName、headRefOid。從 body 與已知任務記錄解析完整 owner/repo#number，短 `#N` 屬於 PR 所在 repo，不能一律轉成中央 repo。
2. 讀取關聯 Issue 及既有 comments、父子關係、驗收報告。AI 比對是否同一需求、跨 repo 是否完成、是否已有相同版本／狀態通知；不要因 PR 合併就稱整體驗收完成。
3. 起草繁體中文通知，列 PR URL、實際狀態、受驗版本、已確認結果與未驗證／未完成項。AI 先自審修訂，再展示目的 Issue 與具體 body。使用 [狀態模板](../../templates/issue-status-comment.md) 的適用欄位，不捏造報告或部署證據。
4. 僅在明確授權留言時使用 structured tool 或 `gh issue comment --repo <verified-repo> <number> --body-file <file>`。參數正確 shell quoting；body 保存真實換行。已有授權不再重問，dry-run 只存草稿。
5. 回讀留言 URL 與內容。timeout 先查最新 comments，結果未知保留待查狀態；不得重送相同通知。部分成功保存已完成 URL，只補未完成目標。
6. 關閉 Issue 需明確授權且符合該卡 Done 條件；子 PR 合併不自動關閉仍有跨 repo 或驗收缺口的中央卡。關閉後回讀狀態。更新 Board 也需在授權範圍內。

回報各目標的草稿或留言 URL、實際 Issue 狀態及未完成事項。原命令式 `--dry-run`／`--close`／`--body` 只表示使用者意圖，不宣稱本 skill 有可執行 CLI parser。