doc-issues skills 加入看板進度欄位調整、附件讀取、子母議題關閉與專案完成模式 #32

2026-07-16T01:49:38Z

jiantw83 commented

2026-07-16 01:49:38 +00:00

變更摘要

為 doc-issues 系列技能加入五項新規則（兩輪變更，版本 0.1.6 → 0.1.8）：doc-issues-sync 依勾稽結果調整專案看板進度欄位、新增專案完成模式（指定關閉專案時批次搬「已完成」並關閉議題）；doc-issues-analyze 分析完成後把議題移到「待處理」欄位、處理議題時連同留言與附件一起讀取、子母議題必須所有子議題關閉後母議題才可關閉。

重點內容

`skills/doc-issues-sync/SKILL.md`

依勾稽結果調整看板進度欄位：

前置新增「專案進度欄位」定義：議題屬於看板且欄位語意可對應（分析中／待處理／進行中／待測試／已完成，以看板實際欄位名稱為準）才處理。
新增第 3.5 步：subagent 依議題描述與 TODO 勾稽結果建議欄位（需求不明→分析中、TODO 齊全未實作→待處理、部分完成→進行中、全完成待驗證→待測試、全完成無需確認→已完成）。
品質檢查：建議只用看板實際欄位，且與勾稽結果一致（有未完成 TODO 不得建議「已完成」）。
套用階段：先探測 Gitea project/column API（404/501 視為不支援、不對未確認端點寫入）；不支援時改列「議題 → 建議欄位」清單請使用者手動拖曳。

專案完成模式（新增專節）：

觸發：輸入為專案且使用者明確指定「關閉專案／專案完成」；語意不明用 AskUserQuestion 確認，單一議題不適用。
流程：只執行到第 1 步取得專案議題清單，跳過標籤分組、subagent 勾稽、標籤更新與進度留言；列出議題清單（含仍有未完成 TODO 者，明確標出）→ 使用者確認（全部執行／逐議題確認／取消）→ 逐議題搬到「已完成」欄位（同一套 API 探測規則）並關閉議題；單筆失敗不中斷整批。
回報搬移／關閉成功與失敗清單、照關但含未完成 TODO 的議題清單；專案看板本身的關閉提示使用者手動處理。

`skills/doc-issues-analyze/SKILL.md`

分析完成移看板「待處理」：保存議題與所有小功能議題建立完成後，把屬於專案看板的議題移到「待處理」欄位；不往回移；同樣先探測 API、不支援時列建議清單。
議題連同留言與附件一起讀取：附件清單走 assets API（議題與留言附件皆含）；文字附件以 curl 直接取內容不落地；圖片等二進位附件依「絕對準則」新開的窄例外唯讀暫存下載到系統暫存目錄、讀完即刪；無法讀取的附件列出檔名標註「需人工確認」。
子母議題關閉規則：保存議題（母）必須所有小功能議題（子）關閉後才可關閉 — 優先以 Gitea issue dependency 把母議題設為 blocked by 每個子議題；不支援時在母議題描述加入子議題清單與「關閉前檢查」。實作完成只關閉子議題，所有子議題關閉後詢問使用者才可關閉母議題。

文件與版本

README.md：開頭摘要、目錄樹、doc-issues-sync／analyze 說明段同步更新。
三份 plugin.json：更新 doc-issues skills 描述，版本 0.1.6 → 0.1.7 → 0.1.8。

影響範圍與風險

僅影響 doc-issues-sync 與 doc-issues-analyze 兩個技能，其他技能不受影響。
看板欄位與 dependency 操作都採「先探測、不支援就退回建議清單／人工標註」的保守策略，不對不存在的 API 端點寫入。
專案完成模式會批次關閉議題（不易復原），故強制經使用者確認、含未完成 TODO 的議題須在確認時明確標出、不得關閉不屬於該專案的議題。
doc-issues-analyze 的「不落地」絕對準則新增附件暫存讀取的窄例外（唯讀、系統暫存目錄、讀完即刪），其餘不落地限制不變。

Commits

feat(doc-issues skills): sync 依勾稽結果調整看板進度欄位；analyze 加入分析完成移待處理、議題連同留言與附件讀取、子母議題關閉規則
docs(README): 同步 doc-issues-sync／analyze 看板欄位、附件讀取與子母議題關閉規則說明
chore(plugin 設定): 更新 doc-issues skills 描述並 bump 版本至 0.1.7
feat(doc-issues-sync skill): 新增專案完成模式：指定關閉專案時批次把專案議題搬到已完成並關閉
docs(README): 補上 doc-issues-sync 專案完成模式說明
chore(plugin 設定): 更新 doc-issues-sync 描述並 bump 版本至 0.1.8

## 變更摘要為 doc-issues 系列技能加入五項新規則（兩輪變更，版本 0.1.6 → 0.1.8）：`doc-issues-sync` 依勾稽結果調整專案看板進度欄位、新增專案完成模式（指定關閉專案時批次搬「已完成」並關閉議題）；`doc-issues-analyze` 分析完成後把議題移到「待處理」欄位、處理議題時連同留言與附件一起讀取、子母議題必須所有子議題關閉後母議題才可關閉。 ## 重點內容 ### `skills/doc-issues-sync/SKILL.md` **依勾稽結果調整看板進度欄位**： - 前置新增「專案進度欄位」定義：議題屬於看板且欄位語意可對應（分析中／待處理／進行中／待測試／已完成，以看板實際欄位名稱為準）才處理。 - 新增第 3.5 步：subagent 依議題描述與 TODO 勾稽結果建議欄位（需求不明→分析中、TODO 齊全未實作→待處理、部分完成→進行中、全完成待驗證→待測試、全完成無需確認→已完成）。 - 品質檢查：建議只用看板實際欄位，且與勾稽結果一致（有未完成 TODO 不得建議「已完成」）。 - 套用階段：先探測 Gitea project/column API（404/501 視為不支援、不對未確認端點寫入）；不支援時改列「議題 → 建議欄位」清單請使用者手動拖曳。 **專案完成模式（新增專節）**： - 觸發：輸入為專案且使用者明確指定「關閉專案／專案完成」；語意不明用 AskUserQuestion 確認，單一議題不適用。 - 流程：只執行到第 1 步取得專案議題清單，跳過標籤分組、subagent 勾稽、標籤更新與進度留言；列出議題清單（含仍有未完成 TODO 者，明確標出）→ 使用者確認（全部執行／逐議題確認／取消）→ 逐議題搬到「已完成」欄位（同一套 API 探測規則）並關閉議題；單筆失敗不中斷整批。 - 回報搬移／關閉成功與失敗清單、照關但含未完成 TODO 的議題清單；專案看板本身的關閉提示使用者手動處理。 ### `skills/doc-issues-analyze/SKILL.md` 1. **分析完成移看板「待處理」**：保存議題與所有小功能議題建立完成後，把屬於專案看板的議題移到「待處理」欄位；不往回移；同樣先探測 API、不支援時列建議清單。 2. **議題連同留言與附件一起讀取**：附件清單走 assets API（議題與留言附件皆含）；文字附件以 curl 直接取內容不落地；圖片等二進位附件依「絕對準則」新開的窄例外唯讀暫存下載到系統暫存目錄、讀完即刪；無法讀取的附件列出檔名標註「需人工確認」。 3. **子母議題關閉規則**：保存議題（母）必須所有小功能議題（子）關閉後才可關閉 — 優先以 Gitea issue dependency 把母議題設為 blocked by 每個子議題；不支援時在母議題描述加入子議題清單與「關閉前檢查」。實作完成只關閉子議題，所有子議題關閉後詢問使用者才可關閉母議題。 ### 文件與版本 - `README.md`：開頭摘要、目錄樹、doc-issues-sync／analyze 說明段同步更新。 - 三份 plugin.json：更新 doc-issues skills 描述，版本 0.1.6 → 0.1.7 → 0.1.8。 ## 影響範圍與風險 - 僅影響 doc-issues-sync 與 doc-issues-analyze 兩個技能，其他技能不受影響。 - 看板欄位與 dependency 操作都採「先探測、不支援就退回建議清單／人工標註」的保守策略，不對不存在的 API 端點寫入。 - 專案完成模式會批次關閉議題（不易復原），故強制經使用者確認、含未完成 TODO 的議題須在確認時明確標出、不得關閉不屬於該專案的議題。 - doc-issues-analyze 的「不落地」絕對準則新增附件暫存讀取的窄例外（唯讀、系統暫存目錄、讀完即刪），其餘不落地限制不變。 ## Commits - feat(doc-issues skills): sync 依勾稽結果調整看板進度欄位；analyze 加入分析完成移待處理、議題連同留言與附件讀取、子母議題關閉規則 - docs(README): 同步 doc-issues-sync／analyze 看板欄位、附件讀取與子母議題關閉規則說明 - chore(plugin 設定): 更新 doc-issues skills 描述並 bump 版本至 0.1.7 - feat(doc-issues-sync skill): 新增專案完成模式：指定關閉專案時批次把專案議題搬到已完成並關閉 - docs(README): 補上 doc-issues-sync 專案完成模式說明 - chore(plugin 設定): 更新 doc-issues-sync 描述並 bump 版本至 0.1.8

jiantw83 added 3 commits 2026-07-16 01:49:38 +00:00

feat(doc-issues skills): sync 依勾稽結果調整看板進度欄位；analyze 加入分析完成移待處理、議題連同留言與附件讀取、子母議題關閉規則 d5966eae21

docs(README): 同步 doc-issues-sync／analyze 看板欄位、附件讀取與子母議題關閉規則說明 96b08a1922

chore(plugin 設定): 更新 doc-issues skills 描述並 bump 版本至 0.1.7 a509e2272f

jiantw83 added 3 commits 2026-07-16 01:54:50 +00:00

feat(doc-issues-sync skill): 新增專案完成模式：指定關閉專案時批次把專案議題搬到已完成並關閉 8fdf0bc5be

docs(README): 補上 doc-issues-sync 專案完成模式說明 26c9e62430

chore(plugin 設定): 更新 doc-issues-sync 描述並 bump 版本至 0.1.8 4489908d8a

jiantw83 changed title from ~~doc-issues skills 加入看板進度欄位調整、附件讀取與子母議題關閉規則~~ to doc-issues skills 加入看板進度欄位調整、附件讀取、子母議題關閉與專案完成模式

2026-07-16 01:55:37 +00:00

admin approved these changes 2026-07-16 02:01:23 +00:00

admin merged commit 82dfa3ebc7 into master