refactor(spec-wiki-contents): 目錄頁 check 欄改用 ●/○,取代 [ ]/[x]
GFM 任務清單語法只在 Markdown 清單項目生效,放進表格儲存格只會被渲染成字面 文字,改用 ●(已完成/已產生)/○(未完成/未產生)避免這個問題; plan-wiki/todo-wiki/do-wiki 三個消費端同步更新描述,計畫頁/代辦頁自己的 checklist(- [ ]/- [x])不受影響、原樣保留。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
@@ -172,14 +172,14 @@ scope: <階段 2 產出的 scope>
|
||||
|
||||
1. 寫入 todo 頁。
|
||||
2. 若使用者明確表示不要更新目錄頁,跳過目錄頁更新;否則依 `spec-wiki-contents`〔新增列前先找可合併的既有列〕upsert 本系統對應段落內的表格列。目錄頁不存在才整頁新建(title `CONTENTS`);目錄頁存在但沒有本系統段落時,在頁尾新增一個 `## {英文系統名稱} {中文系統名稱}` 段落;兩種情況都禁止整頁覆蓋,只修改對應列的`代辦`/`是否已完成`/內容欄,或在該段落表格附加新列。
|
||||
3. 若本次於階段 2「選擇要不要合併進既有列」合併到某個計畫列,回目錄頁把該列`是否已產生代辦`由 `[ ]` 改為 `[x]`、`代辦`欄填入本次 TODO 頁連結並讀回確認;找不到對應列時**不得新建混用列**,改以警告回報。未合併時跳過本步驟,直接以新列的`代辦`欄寫入、`計畫`欄留空。
|
||||
3. 若本次於階段 2「選擇要不要合併進既有列」合併到某個計畫列,回目錄頁把該列`是否已產生代辦`由 `○` 改為 `●`、`代辦`欄填入本次 TODO 頁連結並讀回確認;找不到對應列時**不得新建混用列**,改以警告回報。未合併時跳過本步驟,直接以新列的`代辦`欄寫入、`計畫`欄留空。
|
||||
4. 讀回 todo 頁確認內容已更新;有更新目錄頁時也讀回目錄頁確認(含步驟 2、3 的異動)。讀回時若回應含 `content_base64`,必須 base64 解碼後再比對 Markdown 內容是否與預期一致;若回應格式不同,依 Gitea 官方 API 文件取出正文再比對,不可只確認狀態碼或頁面存在。
|
||||
5. 一項一回寫、一項一確認;若任一步失敗,立刻停止,不得把多個 checklist 累積後一起處理。
|
||||
|
||||
目錄頁是單一共用頁面依系統分段、段落標題與六欄表格格式、列合併規則、以及連結來源(查表取得的 `sub_url`/`path`,不使用 percent-encode 的 title)一律依 `/jsc-shared:spec-wiki-contents`,本 skill 不重複定義;新增列範例(未合併既有計畫列時):
|
||||
|
||||
```markdown
|
||||
| | | | [<TODO 頁連結文字>](<查表取得的 path>) | [ ] | todo wiki:<系統名稱> 代辦——執行規則、需求彙整、分群任務與驗收條件 |
|
||||
| | | | [<TODO 頁連結文字>](<查表取得的 path>) | ○ | todo wiki:<系統名稱> 代辦——執行規則、需求彙整、分群任務與驗收條件 |
|
||||
```
|
||||
|
||||
若既有目錄頁沒有本系統的 `## ` 段落與六欄目錄表格,附加一段新的段落到頁面末尾,不得刪除或重排其他系統的段落與既有內容。
|
||||
|
||||
Reference in New Issue
Block a user