From 8af355b147eb61146d002cc008ff450eabbdacb3 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Fri, 17 Jul 2026 08:58:18 +0800 Subject: [PATCH] =?UTF-8?q?docs(README):=20Skills=20=E7=9B=AE=E9=8C=84?= =?UTF-8?q?=E8=A3=9C=E4=B8=8A=E5=85=B1=E7=94=A8=E8=A6=8F=E7=AF=84=EF=BC=88?= =?UTF-8?q?spec-*=EF=BC=89=E6=B8=85=E5=96=AE=E8=88=87=E5=BC=95=E7=94=A8?= =?UTF-8?q?=E6=96=B9=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Fable 5 --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index 2a72cd3..1ac2243 100644 --- a/README.md +++ b/README.md @@ -169,6 +169,22 @@ rm -rf ~/.config/opencode/skills/hello - **Codex**：`$hello`，或用 `/skills` 選單 - **OpenCode**：描述需求自動觸發 +### 共用規範（spec-*） + +以下 skills 是 **code／doc plugins 各 skill 引用的共用規範**：其他 skill 內文以 `/jsc:spec-` 引用時載入；也可單獨呼叫查看規範內容。 + +| Skill | 類型 | 內容 | +| --- | --- | --- | +| `spec-output` | 輸出規範 | 繁體中文（台灣用語）、UTF-8 無 BOM 無亂碼、表格與 Mermaid 呈現、subagent 提示需帶入本規範 | +| `spec-execution` | 執行原則 | 自動執行原則（必要決策才中斷、已知資訊跳過詢問）、不臆測／需人工確認、不擴及無關檔案 | +| `spec-gitea` | Gitea 工具 | tea／API 工具選擇與檢查、GITEA_TOKEN 機密保護、不依賴 jq、API 分頁與 UTF-8 JSON body、host 決定順序 | +| `spec-git-safety` | Git 安全 | 不破壞既有工作（絕不 reset --hard／clean）、git mv 保留歷史、develop → master 後備、pull --ff-only、保守解衝突 | +| `spec-time-log` | 時間與訊息 | Asia/Taipei `yyyy/MM/dd HH:mm:ss` 更新時間與統一同步、`[時間][階段][等級]: 訊息` log 格式、一行一則 | +| `spec-action-params` | Action 參數 | action 參數來源優先序（context／環境變數 → inputs）、secrets／vars 一律視為不可用 | +| `spec-dockerfile` | Dockerfile | 六步流程（參數→安裝→複製→執行→縮小→入口）、多階段建置、固定版號、對外契約不動、自我檢查 | +| `spec-project-board` | Gitea 看板 | 進度欄位語意對應、建議欄位規則、GET 探測（404/501 不支援）、不往回移、不得新建欄位 | +| `spec-doc-funcs-handoff` | 文件化串接 | code 類 skill 完成後完整執行 /jsc:doc-funcs 的標準流程與統一時間戳 | + ---