---
name: spec-project-board
description: JSC plugins 共用「Gitea 專案看板進度欄位規範」：欄位語意對應（分析中／待處理／進行中／待測試／已完成，以看板實際欄位名稱為準）、依需求與 TODO 勾稽結果建議欄位、先 GET 探測 project/column API（404/501 視為不支援、不對未確認端點寫入）、不往回移、不支援時改列建議清單請人工拖曳、不得新建欄位。當其他 skill 內文引用 spec-project-board 或 /jsc-generic:spec-project-board、或需要調整 Gitea 議題所在看板欄位時載入此 skill。單獨被使用者呼叫時，直接說明本規範內容。
---

# spec-project-board — 共用 Gitea 看板進度欄位規範

JSC skills 調整議題所在的專案看板（project board）欄位時，一律遵守以下規範。

## 欄位語意對應

- 看板欄位名稱可對應進度語意時才操作，例如「分析中」「待處理」「進行中」「待測試」「已完成」；一律以看板**實際欄位名稱**為準，語意相近即可對應，**不得假設看板一定有這五欄**。
- 依議題狀態建議欄位的預設規則：

  | 議題狀態 | 建議欄位 |
  | --- | --- |
  | 需求仍不明確、TODO 明顯不足以追蹤需求而需大量補列 | 分析中 |
  | 需求與 TODO 齊全，但尚無任何對應實作 | 待處理 |
  | 部分 TODO 已完成（已有部分實作） | 進行中 |
  | 所有 TODO 已完成，但仍有「需人工確認」項目或尚待驗證 | 待測試 |
  | 所有 TODO 已完成且無需人工確認（僅在使用者確認時） | 已完成 |

- **不往回移**：議題已在建議欄位或更後面的欄位時維持原欄位，不往回移動。

## 介面探測與寫入限制

- `tea` 目前**沒有** project 看板指令；Gitea REST 的 project／column 端點依版本而異。
- 移動前先以 GET 探測端點是否存在（回 404／501 視為該實例不支援），**不得對未確認存在的端點做寫入**。
- 介面可用 → 一次一個議題移動並確認回應成功。
- 介面不支援、看板沒有可對應語意的欄位、或欄位語意對不上 → **不移動、不視為錯誤**：改在回報（或議題留言）中列出「議題 → 建議欄位」建議清單，請使用者到看板手動拖曳。
- **不得新建欄位**；只在建議欄位確實存在於看板且語意對應明確時移動，有疑慮就不動並回報。