feat(error): 新增 ERROR wiki 範本

This commit is contained in:
2026-08-21 16:53:17 +00:00
parent 37c2856893
commit e0dd3072b2
3 changed files with 51 additions and 0 deletions
+10
View File
@@ -26,6 +26,16 @@ Marketplace 統一為 `jsc`(https://gitea.jsc.idv.tw/plugins/jsc.git),安
Claude 由 `hooks/hooks.json` 自動接線;其他 CLI 用 `hooks-install` 技能接線或降級為規則檔。
## 失敗回報範本
這兩個模板給外層的 hook 失敗回報流程使用,不改動現有 hook 行為。
失敗時若要寫入 wiki,套用這兩個檔案即可。
| 範本 | 用途 |
| --- | --- |
| `templates/error-page.md` | 單筆 hook 異常頁 `ERROR_{HASH}`,記錄當次失敗的觸發條件、錯誤摘要與處理結果。 |
| `templates/error-contents.md` | 異常目錄 `ERROR_CONTENTS`,彙整所有異常頁,方便先看最新問題再往下追。 |
## Skills 目錄
呼叫方式:Claude / Antigravity `/jsc-hooks:{name}`;Codex `${name}`;Copilot / Kiro 描述需求自動觸發。
+9
View File
@@ -0,0 +1,9 @@
# 異常目錄 — ERROR_CONTENTS
> 由 `jsc-hooks` 的失敗回報流程維護。新異常附加在文末,查問題時先看最新一筆。
## 異常清單
| 時間 | 頁名 | 存取庫名稱 | 觸發 hook | 退出碼 | 摘要 |
| --- | --- | --- | --- | --- | --- |
| {yyyy-MM-dd HH:mm:ss} | [[ERROR_{HASH}|{error title}]] | {owner}/{repo} | {hook_name} | {exit_code} | {error_summary} |
+32
View File
@@ -0,0 +1,32 @@
# hook 失敗紀錄 — ERROR_{HASH}
> 由 `jsc-hooks` 的失敗回報流程建立。這是一筆單次異常紀錄,不覆寫舊內容;同類失敗再發生時,請另開新頁。
- 頁名:`ERROR_{HASH}`
- 發生時間:{yyyy-MM-dd HH:mm:ss}
- 存取庫名稱:{owner}/{repo}
- CLI:{cli}
- Session:{session_id}
- 觸發 hook:{hook_name}
- 退出碼:{exit_code}
- 錯誤摘要:{error_summary}
## 現象
- {現象描述}
## 可能原因
- {可能原因}
## 處理結果
- {處理方式}
## 相關資訊
| 欄位 | 內容 |
| --- | --- |
| 訊息來源 | {stdin / env / command} |
| 相關輸出 | {stdout / stderr 摘要} |
| 關聯 ticket | [[TICKET_{yyyyMMdd}_{HHmmss}_{HASH}|{ticket 標題}]] |