plugins/gitea
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
125 Commits 9 Branches 0 Tags
master
Commit Graph
22 Commits
Author SHA1 Message Date
jiantw83 89463cd263 docs(wiki): 同步目錄頁條列格式的敘述與工具用法 
README 的工具用法、技能行為清單、連結規則與 wiki 技能本文，全部改寫成
目錄頁的區塊格式：參數名從整列改成整個區塊、key-col 的用途縮回只給轉檔
用、補上取標題與換引言的判準，並登錄新增的驗證腳本。

文件與工具講的不是同一件事，呼叫端就會照舊敘述傳整列的表格文字進去，寫出
半表格半條列的頁面。key-col 的語意變動最容易誤解——它從「要換掉哪一欄」
變成「轉檔時哪一欄持有身分」，敘述不改就會被填成別的欄位。

目錄頁條列、內容頁維持圖表優先，這個區分在每一份文件裡都寫明，避免把改版
範圍誤讀成整個 wiki。結束碼說明一併對回工具現況。

功能範圍：目錄頁版面改版的文件同步。
 2026-09-02 17:22:29 +08:00
jiantw83 9ec18b8a94 feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到 
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。

連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。
 2026-09-02 14:27:18 +08:00
jiantw83 c40b561589 feat(wiki): 目錄頁專用存取庫、HASH 去除截短與 H 前綴 
What：CONTENTS 成為第 15 種頁面類型，解析鏈為 JSC_WIKI_REPO_CONTENTS 到
JSC_WIKI_REPO，刻意不退回型別變數。hash-id 拿掉 8 碼截短與 H 前綴改寫，只留大寫
轉換，輸出完整 40 碼；空輸入改成用法錯誤。新增 page-name.sh、wiki-contents.sh、
migrate-wiki.sh 與 wiki-delete 子命令。

Why：H 前綴會命中 16 個首碼裡的 13 個，還丟掉第 8 碼，把有效熵壓到 28 位元，而且
全庫查不到任何理由紀錄。目錄頁的整列 upsert 原本 14 處只有一處寫成程式，同一段判斷
做 14 次，錯一次就少一筆紀錄。

How：頁名樣式仍收 H 加 7 碼的舊頁，遷移期間讀得到舊頁。wiki-contents.sh 建新頁時
剝掉範本的示範列，否則每個目錄頁第一次建立都會留一列佔位死連結。migrate-wiki.sh
預設只印對照表，--apply 先寫新頁、確認寫成、才刪舊頁；孤兒頁只列不猜，因為 SHA-1
不可逆，新頁名只能靠候選鍵正推。

Who：jsc-gitea
 2026-09-02 11:02:07 +08:00
jiantw83 8467b89a09 feat(wiki): 頁型別新增 MONITOR 
What：
- resolve_wiki_repo 的型別白名單與檔頭註解加上 MONITOR，check-wiki-rules.sh 的 TYPES 一併加入。
- README 的兩處型別列舉加上 MONITOR，環境變數表補一列 JSC_WIKI_REPO_MONITOR。
- wiki 技能的 allowed types 與行為清單的呼叫端補上這個型別與它的擁有者。
- 三份 manifest 的版本一起提升。

Why：
- 技能助理要把巡檢結果寫進 wiki，落點就是監控頁。型別不在白名單裡，wiki-repo 會直接回「unknown wiki type」而拒絕解析，助理連寫都寫不出去。
- 型別串散在五個檔案，只改一處會讓解析通過但檢核工具漏掉，或反過來。所以一次改齊。

How：
- MONITOR 放在型別串尾端，接在 TOOLING 之後。既有順序是依用途分群，不是字母序，所以不重排。
- 環境變數的規則完全沿用既有型別：先讀 JSC_WIKI_REPO_MONITOR，再退回 JSC_WIKI_REPO，不得跨型別代用。這一條由 resolve_wiki_repo 統一處理，新型別自動繼承，不必另寫分支。
- 雜湊來源的規則不寫在這個存放庫。README 已載明雜湊規則的唯一來源是技能準則的命名總表，這裡不複述。
- wiki 技能的 description 原本逐一列舉呼叫端，已經接近長度上限。這次改成括號標注頁型的濃縮寫法，加了一個呼叫端之後整行反而變短，句數維持在上限內。

Who：
技能助理落地帶出來的頁型別需求，四個存放庫同一批改。
 2026-09-01 12:10:40 +08:00
jiantw83 8da586c481 docs(gitea): 更正過期說明並補齊指令用法 
說明文件有兩處與現況不符。雜湊規則在這裡複述了一份，跟唯一來源各說各
話，讀的人會照著舊的做；技能組異動報告的雜湊來源早就改過，敘述卻留在
原地。現在改成指向唯一來源，並刪掉重複的那一份。

新增的指令、頁面類型與全腳本共用的結束碼也一併寫進說明。查不到就只能
翻程式，那正是說明文件該擋下來的成本。domain 簡介補上議題轉換與 HTML
匯出，與實際提供的技能一致。
 2026-08-31 11:12:20 +08:00
Jeffery d4466dfba8 fix(gitea): 寫入前先確認 2026-08-28 17:55:51 +08:00
jiantw83 3fe9b55840 feat(gitea): 支援回覆 PR 留言 2026-08-28 09:30:02 +08:00
jiantw83 c3b46c982f docs(gitea): README 補上 SKILLSET 頁型與專用環境變數 
What：`README.md` 兩處增修。`wiki-repo` 的用法說明把允許的 `TYPE` 清單補到十二種（加上 `CHECK`、`REPORT`、`SKILLSET`）；環境變數表新增 `JSC_WIKI_REPO_SKILLSET` 一列，寫明對應 `SKILLSET_CONTENTS`、`SKILLSET_{HASH}`（技能組異動報告）與雜湊來源 `{owner}/{repo}`。

Why：README 的類型清單停在九種，`CHECK` 與 `REPORT` 支援了卻沒補上。照 README 設定環境變數的人會以為這幾種頁型沒有專用變數，只能全塞進共用的 `JSC_WIKI_REPO`。

How：`SKILLSET` 單獨列一列而不是併進 `JSC_WIKI_REPO_{TYPE}` 那一行，因為它要多寫雜湊來源；`JSC_WIKI_REPO_{TYPE}` 那一行只補清單，退回規則不動，兩列都保留「不做跨類型代用」這句。

Who：讀 `jsc-gitea` 說明設定 wiki 位置的操作者。
 2026-08-27 16:34:17 +08:00
jiantw83 73cca6e6ea docs(gitea): README 與 AGENTS 補上盯 PR 與 PR 校準的用法 
What：README 的指令清單補上 `pr-get`、`pr-edit` 與 `pr-watch.sh` 三項與各自的退出碼，環境變數表補 `JSC_HOME` 與 `JSC_PR_WATCH_INTERVAL`；AGENTS.md 新增一條規則，盯 PR 等合併一律用 `tools/pr-watch.sh`，不要自己寫輪詢迴圈。

Why：新指令沒寫進 README，呼叫端就只能翻腳本原始碼。`pr-watch.sh` 的退出碼 `10` 更要講清楚：它不是錯誤，是「有新留言，換你處理」的交棒訊號，看成錯誤就會把留言吞掉。

How：README 依既有版面把三項排進指令區塊，另補一段說明退出碼 `10` 的設計意圖。AGENTS.md 把新規則插進第 5 條，原第 5 條順延為第 6 條。

Who：讀 `jsc-gitea` 說明的人，以及依 AGENTS.md 行事的代理。
 2026-08-27 11:20:27 +08:00
jiantw83andClaude Opus 5 dc17907554 chore(gitea): markdown 渲染子命令與文件、manifest 同步 
What：gitea.sh 新增 markdown 子命令與可切換的 Content-Type，README 補上新工具、新技能與 HTML 範本說明，三份 manifest 同步升版到 0.1.3。

Why：markdown 轉 HTML 要交給 Gitea 自己渲染，排版才跟 wiki、議題頁一致；但 /markdown 端點在 Gitea 1.27 回 200 卻是空內容，看起來像成功。

How：改走吃純文字的 /markdown/raw，req 送出的 Content-Type 改由 REQ_CONTENT_TYPE 決定，預設仍是 application/json。代價寫進註解：raw 端點不吃 wiki 情境，[[頁名]] 要由呼叫端先換成絕對網址。

Who：所有透過 jsc-gitea 產生文件的技能。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-26 09:19:25 +08:00
jiantw83andClaude Opus 5 3a2eb40bef docs(gitea): 同步文件與參考資料 
What：更新 README、AGENTS.md、templates 與 references，讓文件敘述與實際行為一致。

Why：稽核發現多處文件與程式行為分歧，違反「每個意義只有單一真實來源」。

How：以實際程式行為為準改寫敘述，重複的規則收成單一來源並以一行指引指過去。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 f65bb40cfc docs(README): 補上 pr-status、pr-comments 與 wiki-url 的工具說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-25 12:08:11 +08:00
jiantw83andClaude Opus 5 60910f7b23 docs(wiki): 補上 wiki 連結的方向與作用範圍規範 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:54:19 +08:00
jiantw83andClaude Opus 5 55d9c79bf7 docs(README): 安裝入口改為 plugins/meta 並補上遷移說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
jiantw83andClaude Opus 5 9607bae6c3 docs(README): 頁型清單同步收錄 DELIVER 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 17:24:31 +08:00
jiantw83andClaude Fable 5 2f4b4ce519 docs(readme): 文件頁型清單同步收錄 LEARN 
What：README.md 的 wiki-repo 指令說明、wiki 技能簡介與 JSC_WIKI_REPO_{TYPE} 環境變數表，頁型清單皆補上 LEARN。
Why：程式端已收錄 LEARN 頁型，文件若不同步，使用者會誤以為 LEARN 不受支援或漏設 JSC_WIKI_REPO_LEARN。
How：三處型別列舉由 QUESTION / PLAN / ANALYZE / MAINTAIN / REPO / LOG / ERROR 更新為含 LEARN 的完整清單，其餘敘述不變。
Who：jsc-gitea 外掛的使用說明文件。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-24 11:37:01 +08:00
jiantw83 11082f648e fix(wiki): 依頁面類型解析 wiki repo 並統一 hash 2026-08-21 16:53:17 +00:00
jiantw83andClaude Fable 5 1f17f1779a feat(wiki): wiki 技能新增圖表優先內容規則並更新 README 說明 
What（改了什麼）
- skills/wiki/SKILL.md 新增兩條規則：頁面內容以圖表優先（mermaid 流程圖、時序圖、甘特圖、圓餅圖與 markdown 表格），純文字為最後手段且保持精簡；tools/gitea.sh 已內建認證退回機制，兩條路徑都失敗才回報認證錯誤。
- SKILL.md frontmatter description 補上 chart-first 說明，讓技能挑選時就能看到此規則。
- README.md：「Skills 目錄」的 wiki 條目補上圖表優先說明；環境變數表的 GITEA_TOKEN 一列補上 401/403 自動退回 tea CLI token 的行為。

Why（為什麼改）
- 使用者規則：wiki 輸出盡量用 mermaid 與表格呈現，不要只有純文字。
- 認證退回已在 tools/gitea.sh 實作，技能文件與 README 需同步，避免技能誤判認證失敗或文件與行為不一致。

How（怎麼改）
- 在 SKILL.md 規則清單追加第 4、5 條，並同步改寫 frontmatter description。
- README 對應兩處文字更新，與 gitea.sh 的實際行為一致。

Who（影響哪個功能／使用者）
- 使用 jsc-gitea:wiki 的所有呼叫方（jsc-ask、jsc-sdlc、jsc-log）：之後寫出的 wiki 頁會以圖表為主；閱讀 README 的使用者能得知 token 退回行為。

備註：README.md 的 GITEA_TOKEN 環境變數表一列在語意上屬於前一個 commit（tea token 退回），但為避免以 hunk 拆分 README，整檔併入本 commit。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 08:23:27 +00:00
jiantw83andClaude Fable 5 e2c4f1733a style(gitea): 中文並列改頓號 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:29:45 +08:00
jiantw83andClaude Fable 5 3468a564aa docs(gitea): README 安裝/更新/移除改為每指令一行（五個 CLI）並為相關 domain 加上 repo 連結 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:35 +08:00
jiantw83andClaude Fable 5 a4bf8636c4 docs(gitea): 以統一格式改寫繁體中文 README 與 AGENTS 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83 8f74c7b46c Initial commit 2026-08-21 04:42:24 +00:00