plugins/gitea
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

gitea 0.1.3 發佈：wiki 轉議題、HTML 匯出與範本風格設定 #19

Merged
admin merged 9 commits from develop into master 2026-08-26 01:34:01 +00:00
Conversation 1 Commits 9 Files Changed 32
+1532 -81
jiantw83 commented 2026-08-26 01:32:45 +00:00
Member
Copy Link
Copy Source

摘要

  • 需求描述：把 develop 上累積的 jsc-gitea 變更發佈到 master——新增三支技能（wiki 轉議題、HTML 匯出、範本風格設定），以及前一輪稽核修正。
  • 計畫名稱：無
  • 計畫頁：無
  • 分析頁：無

變更內容

檔案 為什麼改
skills/wiki-to-issue/、skills/html-export/、skills/html-style/ 本輪新增的三支技能
tools/gitea-link.sh、tools/issue.sh、tools/html-style.sh、tools/html-render.sh 三支技能的標準輸入輸出流程
tools/gitea.sh 新增 markdown 子命令；送出的 Content-Type 改為可切換
templates/html/ 六種版型、五種風格、共用排版與共用腳本
README.md、三份 manifest 文件與版本同步，版本 0.1.3
前一輪稽核（#17） 補齊稽核缺失、修掉護欄失效、文件與參考資料同步

設計重點

  • 兩支轉換技能都以一條連結為唯一入口，解不出來就中止，不猜存取庫也不猜頁名。
  • 版型與風格分開，六乘五共三十種組合，比三十個各自維護的範本檔好改。
  • Gitea 1.27 沒有專案看板 API，issue.sh projects exit 3 並印出手動指引，不假裝關聯成功。

測試結果

  • 合併進 develop 前的驗證：四支新腳本 sh -n 通過；gitea-link.sh、issue.sh、html-style.sh 逐項實測符合預期；三十種版型風格組合全部產出成功；ste100-lint.sh、check-wiki-rules.sh 通過。
  • 本次發佈範圍與 develop 完全相同，沒有額外變更。

前置 Push Request

  • 無
## 摘要 - 需求描述：把 develop 上累積的 jsc-gitea 變更發佈到 master——新增三支技能（wiki 轉議題、HTML 匯出、範本風格設定），以及前一輪稽核修正。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | `skills/wiki-to-issue/`、`skills/html-export/`、`skills/html-style/` | 本輪新增的三支技能 | | `tools/gitea-link.sh`、`tools/issue.sh`、`tools/html-style.sh`、`tools/html-render.sh` | 三支技能的標準輸入輸出流程 | | `tools/gitea.sh` | 新增 markdown 子命令；送出的 Content-Type 改為可切換 | | `templates/html/` | 六種版型、五種風格、共用排版與共用腳本 | | `README.md`、三份 manifest | 文件與版本同步，版本 0.1.3 | | 前一輪稽核（#17） | 補齊稽核缺失、修掉護欄失效、文件與參考資料同步 | ## 設計重點 - 兩支轉換技能都以一條連結為唯一入口，解不出來就中止，不猜存取庫也不猜頁名。 - 版型與風格分開，六乘五共三十種組合，比三十個各自維護的範本檔好改。 - Gitea 1.27 沒有專案看板 API，`issue.sh projects` exit 3 並印出手動指引，不假裝關聯成功。 ## 測試結果 - 合併進 develop 前的驗證：四支新腳本 `sh -n` 通過；`gitea-link.sh`、`issue.sh`、`html-style.sh` 逐項實測符合預期；三十種版型風格組合全部產出成功；`ste100-lint.sh`、`check-wiki-rules.sh` 通過。 - 本次發佈範圍與 develop 完全相同，沒有額外變更。 ## 前置 Push Request - 無
jiantw83 added 9 commits 2026-08-26 01:32:45 +00:00
fix(gitea): 補齊稽核缺失並修掉護欄失效 36fc4de73c 
What：依 jsc-meta:skill-check 的稽核結果修正技能與工具——補上每個步驟的可檢核完成條件、
把留在內文的標準輸入輸出流程下放 tools/、修正查表與退碼路由造成的誤判。

Why：稽核發現這些缺失會讓技能在實際執行時走錯分支或靜默通過。
完成條件缺漏是最常被違反的一項；退碼誤判與查表錯誤則會讓良性狀況被當成失敗。

How：逐項對照 references/guidelines.md 的審核檢查清單修正，新增的工具都有
documented exit codes，並以真實執行驗證每條路徑。

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
docs(gitea): 同步文件與參考資料 3a2eb40bef 
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>
chore(gitea): 三份 manifest 同步升版並同步 marketplace 正本 768ae6a9fe 
What：三份 plugin manifest 版本同步 bump，兩份 marketplace 檔與 plugins/meta 正本對齊。

Why：準則要求技能異動必須同步升版；marketplace 副本必須與正本完全一致。

How：以 jsc-meta 的 tools/sync-skill-manifest.sh 升版，marketplace 檔由正本複製。

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Merge pull request 'fix/skillset-audit-compliance-and-guard-fixes' (#17) from fix/skillset-audit-compliance-and-guard-fixes into develop 8f94069ceb 
Reviewed-on: #17
feat(gitea): 新增 wiki 轉議題技能 f8123e829b 
What：新增 wiki-to-issue 技能，把一頁 wiki 轉成同一個存取庫的議題；配套新增 tools/gitea-link.sh 解析連結、tools/issue.sh 讀寫議題。

Why：wiki 頁要變成可追蹤的工作時，原本得自己拼 API：組 JSON、查標籤 id、挑回應欄位，跳脫一錯就把對外的議題內容寫壞。

How：連結是唯一入口，gitea-link.sh 解不出 wiki 頁就中止，不猜存取庫也不猜頁名；標籤只從既有的挑；站台沒有專案看板 API 時據實回報請使用者手動拖，不假裝關聯成功。

Who：使用 jsc 技能組、需要把 wiki 內容交辦出去的人。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
feat(gitea): 新增 HTML 匯出與範本風格設定 a0c13f807a 
What：新增 html-export 與 html-style 兩支技能、tools/html-render.sh 與 tools/html-style.sh 兩支工具，以及六種版型乘五種風格的 HTML 範本。

Why：wiki 頁與議題要拿給 Gitea 以外的人看時，只能複製 markdown；不同類型的文件也該有各自的版面，不是每份都長一樣。

How：版型（report、slide、dashboard、spec、timeline、onepager）決定內容怎麼排，風格（minimal、corporate、dark、print、vivid）決定看起來長怎樣，兩者自由搭配。哪一種頁面套哪一組由設定決定：專案的 .jsc/html-styles 優先，其次 $JSC_HOME/html-styles.conf，對不到退 DEFAULT，再對不到才用內建的 report／minimal。產出是單一 HTML 檔，CSS 與腳本全部內嵌。

Who：需要把 wiki 頁或議題寄給客戶、主管或跨團隊同事的人。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
chore(gitea): markdown 渲染子命令與文件、manifest 同步 dc17907554 
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>
chore(gitea): manifest 描述補上議題轉換與 HTML 匯出 dbe800d7a7 
What：三份 plugin manifest 的 description 補上這次新增的兩類能力。

Why：description 是各 CLI 顯示這個 plugin 用途的依據，少了新能力就找不到人用。

How：三份同步改成同一句；marketplace 正本的條目描述留給下一次 skill-check 統一處理，因為那份要同時改到十一個存取庫的副本。

Who：在 CLI 裡挑 plugin 的人。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Merge pull request 'feat(gitea): wiki 轉議題、HTML 匯出與範本風格設定' (#18) from feat/wiki-to-issue-and-html-export into develop 5b3aa3959b 
Reviewed-on: #18
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
admin approved these changes 2026-08-26 01:33:59 +00:00
admin merged commit 81de5b1e1e into master 2026-08-26 01:34:01 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: plugins/gitea#19