docs(wiki skills): 更新計畫與代辦頁預設規則
This commit is contained in:
Codex
+20
-15
@@ -1,7 +1,7 @@
|
||||
---
|
||||
name: plan-wiki
|
||||
description: 逐步詢問使用者計畫內容，並把每一輪已確認的計畫草稿直接同步到指定 Gitea wiki 的目錄頁與計畫頁，全程不建立本機計畫檔、草稿檔、暫存 JSON body 或 wiki clone。使用者要建立計畫、把計畫加入 wiki 目錄、指定 Gitea wiki repo／目錄頁／計畫頁、要求邊問邊同步 wiki、要求計畫檔案不落地、或提到 plan-wiki、計畫 wiki、wiki 目錄頁時觸發。適用於：需求尚未完整、需要逐題釐清並保存到 wiki 的計畫文件。不適用於：產生本機 plan.md／todo.md、拆 Gitea issue（用 /jsc-doc:issues-analyze）、或非 Gitea wiki。
|
||||
argument-hint: "[--wiki-repo <owner/repo>] [--index <目錄頁title>] [--project <計畫名稱>] [--page <計畫頁title>] [--host <gitea主機>] [--yes]"
|
||||
argument-hint: "[--wiki-repo <owner/repo>] [--index CONTENTS] [--project <計畫名稱>] [--page PLAN-<yyyyMMdd>-<HASH>] [--host <gitea主機>] [--yes]"
|
||||
---
|
||||
|
||||
# plan-wiki — 逐步建立計畫並同步到 Gitea wiki
|
||||
@@ -24,7 +24,10 @@ argument-hint: "[--wiki-repo <owner/repo>] [--index <目錄頁title>] [--project
|
||||
|
||||
本 skill 特有補充：
|
||||
|
||||
- 本 skill 會寫入外部 Gitea wiki；目標 wiki repo、目錄頁、計畫頁不明時必須詢問，不得臆測。
|
||||
- 本 skill 會寫入外部 Gitea wiki；目標 wiki repo 不明時必須詢問，不得臆測。
|
||||
- 目錄頁 title 預設固定為 `CONTENTS`，不詢問使用者；只有使用者明確提供 `--index` 時才覆蓋預設值。
|
||||
- 計畫頁 title 預設固定為 `PLAN-{yyyyMMdd}-{HASH}`，不詢問使用者；`yyyyMMdd` 使用 Asia/Taipei 當日日期，`HASH` 由已確認的計畫內容、計畫名稱或需求摘要產生穩定短雜湊並轉成全大寫。
|
||||
- 加入目錄頁時，先從計畫內容尋找系統名稱；若無明確系統名稱，依計畫目標產生一個精簡系統名稱。目錄標題使用 `{系統名稱}-計畫`，並連結到計畫頁。
|
||||
- **不落地絕對規則**：不得建立本機 `plan.md`、`todo.md`、`.md` 草稿、暫存 JSON body、wiki clone、或任何用來傳遞中間成果的檔案；中間成果只存在於對話內容與 Gitea wiki API request body。不得使用 `curl --data @file`。
|
||||
- 使用者已用參數指定 `--wiki-repo`、`--index`、`--project`、`--page` 時跳過對應詢問。
|
||||
- 每一輪使用者回答後都要同步 wiki。同步失敗時停止下一輪詢問，先回報錯誤與待使用者處理的點。
|
||||
@@ -32,14 +35,14 @@ argument-hint: "[--wiki-repo <owner/repo>] [--index <目錄頁title>] [--project
|
||||
|
||||
## 參數
|
||||
|
||||
`[--wiki-repo <owner/repo>] [--index <目錄頁title>] [--project <計畫名稱>] [--page <計畫頁title>] [--host <gitea主機>] [--yes]`
|
||||
`[--wiki-repo <owner/repo>] [--index CONTENTS] [--project <計畫名稱>] [--page PLAN-<yyyyMMdd>-<HASH>] [--host <gitea主機>] [--yes]`
|
||||
|
||||
| 參數 | 說明 |
|
||||
| --- | --- |
|
||||
| `--wiki-repo` | Gitea wiki 所屬 repo，例如 `knowledges/Plan`。未帶且無法從目前 repo 推得時詢問使用者。 |
|
||||
| `--index` | 目錄頁 title，預設可詢問使用者；若使用者明確說「目錄」可用 `目錄`。 |
|
||||
| `--project` | 計畫名稱，用於目錄頁 H1、說明與預設頁名。 |
|
||||
| `--page` | 計畫頁 title；未帶時用 `<project> 計畫`，但需先告知使用者。 |
|
||||
| `--index` | 目錄頁 title；未帶時固定使用 `CONTENTS`，不詢問。 |
|
||||
| `--project` | 計畫名稱；未帶時從計畫內容尋找或產生系統名稱，用於目錄列標題與摘要。 |
|
||||
| `--page` | 計畫頁 title；未帶時固定使用 `PLAN-{yyyyMMdd}-{HASH}`，不詢問。 |
|
||||
| `--host` | Gitea 主機，依 `spec-gitea` host 決定順序處理。 |
|
||||
| `--yes` | 略過一般性確認；不得略過目標 wiki 不明、寫入衝突或使用者尚未確認的計畫完成判斷。 |
|
||||
|
||||
@@ -47,8 +50,10 @@ argument-hint: "[--wiki-repo <owner/repo>] [--index <目錄頁title>] [--project
|
||||
|
||||
1. 依 `spec-gitea` 決定 host 與 token，只輸出 token「已設定／未設定」。
|
||||
2. 確認 `--wiki-repo` 是否為 `owner/repo` 格式；不符合時詢問使用者修正。
|
||||
3. 確認目錄頁 title、計畫名稱、計畫頁 title。
|
||||
4. 用 `GET /repos/<owner>/<repo>` 驗證 token 對 repo 有權限；失敗時遮蔽機密後回報並停止。
|
||||
3. 確認目錄頁 title：未帶 `--index` 時固定使用 `CONTENTS`。
|
||||
4. 確認計畫頁 title：未帶 `--page` 時固定使用 `PLAN-{yyyyMMdd}-{HASH}`。雜湊輸入優先使用已確認的計畫內容；內容不足時使用計畫名稱、來源摘要與當輪時間組合，輸出全大寫短雜湊。
|
||||
5. 確認系統名稱：先從 `--project`、計畫內容、需求來源或使用者回答尋找明確系統名稱；找不到時產生精簡系統名稱，不為此單獨詢問。
|
||||
6. 用 `GET /repos/<owner>/<repo>` 驗證 token 對 repo 有權限；失敗時遮蔽機密後回報並停止。
|
||||
|
||||
## 階段 B：讀取 wiki 現況
|
||||
|
||||
@@ -62,18 +67,18 @@ argument-hint: "[--wiki-repo <owner/repo>] [--index <目錄頁title>] [--project
|
||||
目錄頁必須維持下列結構；更新時保留既有列，只新增或更新本計畫相關列：
|
||||
|
||||
```markdown
|
||||
# <project> 計畫
|
||||
# CONTENTS
|
||||
|
||||
<一段計畫說明。>
|
||||
計畫目錄。
|
||||
|
||||
| 頁面 | 內容 |
|
||||
|------|------|
|
||||
| [<page title>](<page title percent-encoded, 空白用 %20>) | <頁面內容摘要> |
|
||||
| [<系統名稱>-計畫](<page title percent-encoded, 空白用 %20>) | plan wiki：<系統名稱> 計畫 |
|
||||
|
||||
產出日期：yyyy-MM-dd
|
||||
```
|
||||
|
||||
若目錄頁已存在且不是單一計畫專用目錄，仍以同一張 `| 頁面 | 內容 |` 表格為準：保留原標題與說明，只在表格中 upsert 本計畫頁面列。連結文字用頁面 title；連結 target 用 `encodeURIComponent(title).replace(/%20/g, "%20")` 的結果，不使用 API `sub_url` 反推人工連結。
|
||||
若目錄頁已存在且不是單一計畫專用目錄，仍以同一張 `| 頁面 | 內容 |` 表格為準：保留原標題與說明，只在表格中 upsert 本計畫頁面列。連結文字固定為 `<系統名稱>-計畫`；連結 target 用 `encodeURIComponent(title).replace(/%20/g, "%20")` 的結果，不使用 API `sub_url` 反推人工連結。
|
||||
|
||||
## 計畫頁格式
|
||||
|
||||
@@ -122,7 +127,7 @@ argument-hint: "[--wiki-repo <owner/repo>] [--index <目錄頁title>] [--project
|
||||
每輪同步順序固定：
|
||||
|
||||
1. 更新計畫頁。
|
||||
2. 更新目錄頁，確保表格中有本計畫頁連結與摘要。
|
||||
2. 更新目錄頁，確保表格中有本計畫頁連結與摘要；目錄列標題使用 `<系統名稱>-計畫`。
|
||||
3. 再次讀回兩個頁面確認內容已更新。
|
||||
|
||||
API 寫入方式：
|
||||
@@ -154,6 +159,6 @@ API 寫入方式：
|
||||
|
||||
| 助理 | 呼叫 |
|
||||
| --- | --- |
|
||||
| Claude Code / Antigravity | `/jsc-shared:plan-wiki --wiki-repo knowledges/Plan --index 目錄 --project Kokorone --page "Kokorone 系統架構計畫"` |
|
||||
| Codex | `$plan-wiki --wiki-repo knowledges/Plan --index 目錄 --project Kokorone` |
|
||||
| Claude Code / Antigravity | `/jsc-shared:plan-wiki --wiki-repo knowledges/Plan --project Kokorone` |
|
||||
| Codex | `$plan-wiki --wiki-repo knowledges/Plan --project Kokorone` |
|
||||
| OpenCode | 描述需求（如「逐步問我計畫內容，並同步到 Gitea wiki 目錄與頁面」）自動觸發 |
|
||||
|
||||
Reference in New Issue
Block a user