docs(README): Skills 目錄補上共用規範(spec-*)清單與引用方式

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Jeffery
2026-07-17 08:58:18 +08:00
co-authored by Claude Fable 5
parent 8ad1affc02
commit 8af355b147
+16
View File
@@ -169,6 +169,22 @@ rm -rf ~/.config/opencode/skills/hello
- **Codex**`$hello`,或用 `/skills` 選單 - **Codex**`$hello`,或用 `/skills` 選單
- **OpenCode**:描述需求自動觸發 - **OpenCode**:描述需求自動觸發
### 共用規範(spec-*
以下 skills 是 **codedoc plugins 各 skill 引用的共用規範**:其他 skill 內文以 `/jsc:spec-<name>` 引用時載入;也可單獨呼叫查看規範內容。
| Skill | 類型 | 內容 |
| --- | --- | --- |
| `spec-output` | 輸出規範 | 繁體中文(台灣用語)、UTF-8 無 BOM 無亂碼、表格與 Mermaid 呈現、subagent 提示需帶入本規範 |
| `spec-execution` | 執行原則 | 自動執行原則(必要決策才中斷、已知資訊跳過詢問)、不臆測/需人工確認、不擴及無關檔案 |
| `spec-gitea` | Gitea 工具 | teaAPI 工具選擇與檢查、GITEA_TOKEN 機密保護、不依賴 jq、API 分頁與 UTF-8 JSON body、host 決定順序 |
| `spec-git-safety` | Git 安全 | 不破壞既有工作(絕不 reset --hardclean)、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)、secretsvars 一律視為不可用 |
| `spec-dockerfile` | Dockerfile | 六步流程(參數→安裝→複製→執行→縮小→入口)、多階段建置、固定版號、對外契約不動、自我檢查 |
| `spec-project-board` | Gitea 看板 | 進度欄位語意對應、建議欄位規則、GET 探測(404/501 不支援)、不往回移、不得新建欄位 |
| `spec-doc-funcs-handoff` | 文件化串接 | code 類 skill 完成後完整執行 /jsc:doc-funcs 的標準流程與統一時間戳 |
<!-- JSC-SKILLS:END --> <!-- JSC-SKILLS:END -->
--- ---