chore(plugin 版本): 三家 manifest 升版 0.1.6
This commit is contained in:
@@ -31,7 +31,8 @@ argument-hint: "[--wiki-repo <owner/repo>] [--index CONTENTS] [--project <計畫
|
||||
- 目錄頁禁止整頁覆蓋:不存在時才新建;存在時必須保留既有內容,只修改本計畫既有列或在既有表格附加新列。
|
||||
- **不落地絕對規則**:不得建立本機 `plan.md`、`todo.md`、`.md` 草稿、暫存 JSON body、wiki clone、或任何用來傳遞中間成果的檔案;中間成果只存在於對話內容與 Gitea wiki API request body。不得使用 `curl --data @file`。
|
||||
- 使用者已用參數指定 `--wiki-repo`、`--index`、`--project`、`--page` 時跳過對應詢問。
|
||||
- 每一輪使用者回答後都要同步 wiki。同步失敗時停止下一輪詢問,先回報錯誤與待使用者處理的點。
|
||||
- 每一輪使用者回答後都要同步 wiki;一輪一同步、一輪一確認,不可累積多輪回答後一次送出。同步失敗、讀回失敗或比對不一致時,停止下一輪詢問,先回報錯誤與待使用者處理的點。
|
||||
- 只有階段 D 的 wiki 同步完成且讀回確認成功後,才能進入下一輪提問。
|
||||
- 不要求使用者把 token 貼進對話;token 依 `spec-gitea` 從環境變數或既有設定取得。
|
||||
|
||||
## 參數
|
||||
@@ -45,7 +46,7 @@ argument-hint: "[--wiki-repo <owner/repo>] [--index CONTENTS] [--project <計畫
|
||||
| `--project` | 計畫名稱;未帶時從計畫內容尋找或產生系統名稱,用於目錄列標題與摘要。 |
|
||||
| `--page` | 計畫頁 title;未帶時固定使用 `PLAN-{yyyyMMdd}-{HASH}`,不詢問。 |
|
||||
| `--host` | Gitea 主機,依 `spec-gitea` host 決定順序處理。 |
|
||||
| `--yes` | 略過一般性確認;不得略過目標 wiki 不明、寫入衝突或使用者尚未確認的計畫完成判斷。 |
|
||||
| `--yes` | 略過一般性確認;不得略過目標 wiki 不明、寫入衝突、同步失敗後的停止,或使用者尚未確認的計畫完成判斷。 |
|
||||
|
||||
## 階段 A:前置設定
|
||||
|
||||
@@ -120,6 +121,7 @@ argument-hint: "[--wiki-repo <owner/repo>] [--index CONTENTS] [--project <計畫
|
||||
- 把仍不明確的點列入 `## 待確認`。
|
||||
- 產出或更新 `## TODO` checklist,格式依 `spec-todo-list`。
|
||||
- 詢問使用者下一輪問題前,先完成階段 D 的 wiki 同步。
|
||||
- 如果某輪資料不足,先把不確定內容放進 `## 待確認`,不得自行補完再繼續問下一輪。
|
||||
|
||||
使用者明確表示「完成」「先到這裡」「計畫完成」時,進入階段 E;不要再追問非必要細節。
|
||||
|
||||
@@ -130,6 +132,7 @@ argument-hint: "[--wiki-repo <owner/repo>] [--index CONTENTS] [--project <計畫
|
||||
1. 更新計畫頁。
|
||||
2. 更新目錄頁:不存在才建立;存在時禁止整頁覆蓋,只修改既有 `<系統名稱>-計畫` 列,或在既有表格/頁末附加新列,確保有本計畫頁連結與摘要。
|
||||
3. 再次讀回兩個頁面確認內容已更新。讀回時若回應含 `content_base64`,必須 base64 解碼後比對正文 Markdown 是否與預期一致;若回應格式不同,依 Gitea 官方 API 文件取出正文再比對,不可只確認狀態碼或頁面存在。
|
||||
4. 每輪只允許一輪同步結果對應下一輪提問;若 wiki 寫入失敗、讀回失敗或內容比對不一致,必須停止下一輪詢問,先回報錯誤與待處理點。
|
||||
|
||||
API 寫入方式:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user