From dd047810588f4c188aed7b87a0f1445f99d7c573 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 21 Aug 2026 08:23:53 +0000 Subject: [PATCH] =?UTF-8?q?docs(guidelines):=20=E8=A3=9C=E8=A8=98=20gitea.?= =?UTF-8?q?sh=20=E7=9A=84=20tea=20=E7=99=BB=E5=85=A5=E9=87=91=E9=91=B0?= =?UTF-8?q?=E5=82=99=E6=8F=B4=E6=A9=9F=E5=88=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit What（改了什麼）： - 「技能設計」第 2 條補充：gitea.sh 在 token 未設定或收到 401／403 時，會自動改用 tea 的登入金鑰重試一次。 - 環境變數表 GITEA_TOKEN 的「未設定時」欄位由「詢問使用者」改為「改用 tea 登入金鑰（tea login list）；tea 也沒有才詢問使用者」。 Why（為什麼改）： - gitea.sh 已實作 tea token 備援，但準則文件未記載；技能作者與審核者依文件行事，文件落後會導致誤判認證失敗的處理方式。 How（怎麼改）： - 僅更新 references/guidelines.md 兩處文字，與 jsc-gitea/tools/gitea.sh 的實際行為對齊，不動任何流程或工具。 Who（影響哪個功能／使用者）： - 所有依 guidelines.md 撰寫或審核 jsc 技能的維護者；使用 gitea.sh 的技能在 token 失效時的預期行為自此有文件依據。 Co-Authored-By: Claude Fable 5 --- references/guidelines.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/references/guidelines.md b/references/guidelines.md index 5ba59f0..9b9b8ae 100644 --- a/references/guidelines.md +++ b/references/guidelines.md @@ -35,7 +35,7 @@ ## 技能設計 1. 每個技能必須有單一明確目標，不可與既有技能重複；能複用就複用（呼叫其他技能或工具）。 -2. 需要操作 gitea 且輸入輸出明確的技能，一律透過 `jsc-gitea/tools/gitea.sh`（curl + `GITEA_TOKEN`）或 `tea` CLI，不可自行拼 API 呼叫。 +2. 需要操作 gitea 且輸入輸出明確的技能，一律透過 `jsc-gitea/tools/gitea.sh`（curl + `GITEA_TOKEN`）或 `tea` CLI，不可自行拼 API 呼叫。gitea.sh 在 token 未設定或收到 401／403 時，會自動改用 tea 的登入金鑰重試一次。 3. 需要問使用者的技能，一律透過 `jsc-ask:ask` 的決策樹規則：選項式提問、每個選項標明影響範圍、問到沒有疑慮為止、已有紀錄的答案不再問。 ## 語言 @@ -58,7 +58,7 @@ | 變數 | 用途 | 未設定時 | | --- | --- | --- | | `GITEA_HOST` | Gitea 站台（例：`https://gitea.jsc.idv.tw`） | 詢問使用者 | -| `GITEA_TOKEN` | Gitea API token | 詢問使用者 | +| `GITEA_TOKEN` | Gitea API token | 改用 tea 登入金鑰（`tea login list`）；tea 也沒有才詢問使用者 | | `JSC_WIKI_REPO_{TYPE}` | 各類型 wiki 頁所在的 `{owner}/{repo}`；TYPE = `QUESTION` / `PLAN` / `ANALYZE` / `MAINTAIN` / `REPO` / `LOG` | 退回 `JSC_WIKI_REPO` | | `JSC_WIKI_REPO` | 未逐類設定時的共用 wiki `{owner}/{repo}` | 詢問使用者 | | `JSC_HOME` | Hook 資料目錄 | 預設 `~/.jsc` |