 jiantw83
|
19d918f499
|
docs(templates): 五個目錄頁範本改成大標題加條列
What
- `templates/plan-contents.md`、`templates/analyze-contents.md`、`templates/repo-contents.md`、`templates/deliver-contents.md`、`templates/maintain-contents.md` 的版面從 markdown 表格改成一筆一個 H2 區塊，欄位改成標題底下的一層條列。
- 四個有內容頁的型別，H2 標題寫成該筆對應內容頁的實際頁名；`MAINTAIN` 沒有內容頁，標題改用該存取庫的 `{owner}/{repo}`。
- 各範本的引言補上版面段，並把寫入語意從「單列 upsert」改寫成單一區塊 upsert，末端的示範資料改成一個完整的 H2 區塊。
- 引言裡寫明鍵欄的語意與各頁的正確序號，並點出填錯的靜默後果。
Why
- 目錄頁是全部使用者共用的索引。表格一寬就得橫向捲、欄位一多就對不上表頭，而且併行寫入時只要有人少打一根豎線，整張表就散掉，別人那一筆跟著看不見。
- 條列式一筆一個區塊，寫入端只換自己那一塊，壞掉也只壞自己那一塊。
- `MAINTAIN` 整個型別只有目錄頁，硬套內容頁頁名當標題會指向一個不存在的頁；存取庫名不會漂移，當鍵一樣穩。
- 鍵欄填錯時工具不會報錯，既有那一筆會被當成新的附加到頁尾，同一筆變兩個區塊，舊區塊從此再也更新不到，所以範本要把序號寫死。
How
- 一頁固定三段：H1 頁名、`>` 引言、然後每一筆一個 H2 區塊；欄位格式 `- {欄位名}：{值}`，全形冒號，順序照原本的欄位從左到右，鍵那一欄照樣留一條。
- 寫入示例統一成 `wiki-contents.sh upsert {TYPE} {鍵欄} "{鍵}" {區塊檔} [{本範本}]`，並註明第四個引數是整個 H2 區塊的 markdown，不是列檔。
- 頁上不留任何 markdown 表格；內容頁範本不在本輪範圍，維持圖表優先。
Who
- 影響照這五個範本寫目錄頁的四支階段技能。
- 舊表格頁的自動轉檔與單一區塊 upsert 的實作不在本存取庫，本存取庫只提供範本與敘述。
|
2026-09-02 17:21:10 +08:00 |
|
|
jiantw83
|
f4e489ceb4
|
feat(link): 連結一律寫成 [文字](絕對網址)，寫入前先驗證連得到
取消 [[頁名]] 與 [[顯示文字|頁名]] 兩種同 wiki 寫法，不再分「同存取庫」與
「跨存取庫」兩條規則。那種寫法只在自己那個 wiki 內解析，寫錯不報錯，畫面上
看起來像普通文字或死連結，巡不到也修不了。
連結寫進頁面前先過 jsc-gitea 的 link-check.sh，結束碼 0 才寫。驗證一律走 API，
不看網頁狀態碼：私有存取庫的網頁網址對未登入請求一律回 404，拿狀態碼判會把
好連結判成壞的。認證失敗回 7，與死連結的 1 分開，免得金鑰一過期就把還在的頁
整批判死。
|
2026-09-02 14:27:18 +08:00 |
|
|
jiantw83
|
9e71474bfb
|
feat(wiki): 五個目錄頁改走專用存取庫，補齊 wiki-url 退出碼分流
What：PLAN、ANALYZE、DELIVER、MAINTAIN、REPO 五個目錄頁改由 wiki-repo CONTENTS
解析並透過 wiki-contents.sh upsert 寫入，內容頁仍各走自己的型別。MAINTAIN 只有
目錄頁，整個型別都在專用存取庫。
Why：目錄頁與內容頁不再同庫，跨庫沒有 wiki 連結語法可用，一律改 wiki-url 的絕對
網址。原本四處取網址都沒有退出碼分流，5 被讀成空字串就寫出空連結，7 被讀成 4 就
把活著的頁當成沒寫成。
How：plan 與 analyze 會上階段鎖，而寫入閘門只看鎖不看路徑，所以流程要產的列檔與
暫存檔會被自己的閘門擋掉。兩支的限制段明寫這些檔一律用 heredoc 或 mktemp 產出。
wp-gate.sh 讀的是分析內容頁，維持走 ANALYZE，原地註明不得改成 CONTENTS。
Who：jsc-sdlc
|
2026-09-02 11:02:34 +08:00 |
|
|
jiantw83
|
39a7e17b85
|
feat(contents): 目錄頁改為先讀回再附加
目錄頁的每一列都屬於別人的計畫、工作包或存取庫。過去照範本整頁覆寫，別人的列會直接消失，而且寫入不做合併，也沒有備份。
- 五份目錄範本都寫明寫入語意：先讀回整頁，已有的列就更新，沒有才附加。
- 規劃與維護技能加上讀取結束碼分支表。只有「頁面真的不存在」才准照範本建頁；金鑰失效或 API 失敗一律停下來回報，不得當成沒有頁面。
- wiki 讀或寫失敗就停止該階段，並指出是哪一頁、哪一個動作失敗，避免把沒存成功的頁面報成已存。
- 補上寫入閘門只有 claude 擋得住的事實，其餘四支 CLI 只能靠內文約束。
- 記下工作包閘門對規劃階段降為提醒後放棄的在製品上限。
- 維護階段先整批對齊各專案再逐一交給 sub agent，專案之間互不相依。
|
2026-08-31 11:10:30 +08:00 |
|
 jiantw83andClaude Opus 5
|
2a1dcc59e9
|
fix(wiki 連結): 目錄頁連結方向修正、跨頁型改絕對網址、工作證不再假裝連結
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
2026-08-24 18:54:19 +08:00 |
|
|
jiantw83
|
1153f7f064
|
fix(wiki): 統一 SDLC wiki 頁命名與 ERROR 範本
|
2026-08-21 16:53:17 +00:00 |
|
|
jiantw83andClaude Fable 5
|
167f62a35c
|
feat(sdlc): 匯入 jsc-sdlc 技能組
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
2026-08-21 13:08:43 +08:00 |
|