diff --git a/skills/plan-wiki/SKILL.md b/skills/plan-wiki/SKILL.md index 954b963..0c45e1f 100644 --- a/skills/plan-wiki/SKILL.md +++ b/skills/plan-wiki/SKILL.md @@ -1,12 +1,12 @@ --- name: plan-wiki -description: 逐步詢問使用者計畫內容，持續釐清到系統規劃所需描述完整後，才把詳細分析同步到指定 Gitea wiki 的目錄頁與計畫頁，全程不建立本機計畫檔、草稿檔、暫存 JSON body 或 wiki clone。使用者要建立計畫、把計畫加入 wiki 目錄、指定 Gitea wiki repo／目錄頁／計畫頁、要求計畫檔案不落地、或提到 plan-wiki、計畫 wiki、wiki 目錄頁時觸發。適用於：需求尚未完整、需要逐題釐清並保存到 wiki 的計畫文件。不適用於：產生本機 plan.md／todo.md、產生代辦事項、拆 Gitea issue（用 /jsc-doc:issues-analyze）、或非 Gitea wiki。 +description: 逐步詢問使用者計畫內容，持續釐清到系統規劃所需描述完整後，才把詳細分析同步到指定 Gitea wiki 的目錄頁與計畫頁，全程禁止本機檔案落地，不建立本機計畫檔、草稿檔、暫存 JSON body、附件暫存檔或 wiki clone。使用者要建立計畫、把計畫加入 wiki 目錄、指定 Gitea wiki repo／目錄頁／計畫頁、要求計畫檔案不落地、或提到 plan-wiki、計畫 wiki、wiki 目錄頁時觸發。適用於：需求尚未完整、需要逐題釐清並保存到 wiki 的計畫文件。不適用於：產生本機 plan.md／todo.md、產生代辦事項、拆 Gitea issue（用 /jsc-doc:issues-analyze）、或非 Gitea wiki。 argument-hint: "[--wiki-repo ] [--index CONTENTS] [--project <計畫名稱>] [--page PLAN--] [--host ] [--yes]" --- # plan-wiki — 逐步建立計畫並同步到 Gitea wiki -把「逐步詢問 → 確認描述完整 → 詳細分析計畫 → 同步 wiki 目錄與頁面」固定成流程。必須一直重複詢問使用者，直到蒐集完系統規劃所需的所有描述；凡有疑問或缺口都要詢問，不得自行幻想。只有描述完整後，才可以把詳細分析寫入計畫頁；全程不建立本機計畫檔或草稿檔。 +把「逐步詢問 → 確認描述完整 → 詳細分析計畫 → 同步 wiki 目錄與頁面」固定成流程。必須一直重複詢問使用者，直到蒐集完系統規劃所需的所有描述；凡有疑問或缺口都要詢問，不得自行幻想。只有描述完整後，才可以把詳細分析寫入計畫頁；全程禁止本機檔案落地。 | 階段 | 動作 | | --- | --- | @@ -29,7 +29,7 @@ argument-hint: "[--wiki-repo ] [--index CONTENTS] [--project <計畫 - 計畫頁 title 預設固定為 `PLAN-{yyyyMMdd}-{HASH}`，不詢問使用者；`yyyyMMdd` 使用 Asia/Taipei 當日日期，`HASH` 由已確認的計畫內容、計畫名稱或需求摘要產生穩定短雜湊並轉成全大寫。 - 加入目錄頁時，先從計畫內容尋找系統名稱；若無明確系統名稱，依計畫目標產生一個精簡系統名稱。系統名稱必須是程式碼專案可使用的英文名稱，格式固定為大駝峰（PascalCase），只允許英文字母與數字，且必須以英文字母開頭，例如 `InventoryTracker`。無法可靠產生時必須詢問使用者，不得自行幻想。目錄標題使用 `{系統名稱}-計畫`，並連結到計畫頁。 - 目錄頁禁止整頁覆蓋：不存在時才新建；存在時必須保留既有內容，只修改本計畫既有列或在既有表格附加新列。 -- **不落地絕對規則**：不得建立本機 `plan.md`、`todo.md`、`.md` 草稿、暫存 JSON body、wiki clone、或任何用來傳遞中間成果的檔案；中間成果只存在於對話內容與 Gitea wiki API request body。不得使用 `curl --data @file`。 +- **不落地絕對規則**：全程禁止本機檔案落地。不得建立、更新、下載或暫存任何本機輸出／中介檔案，包含 `plan.md`、`todo.md`、`.md` 草稿、暫存 JSON body、附件暫存檔、wiki clone、或任何用來傳遞中間成果的檔案；中間成果只存在於對話內容、工具參數與 Gitea wiki API request body。不得使用 `curl --data @file`、`--data-binary @file` 或任何 `@file` 形式送出本機檔案。 - 使用者已用參數指定 `--wiki-repo`、`--index`、`--project`、`--page` 時跳過對應詢問。 - 使用者已用 `--project` 指定計畫名稱時，仍需檢查是否符合 PascalCase 英文專案名稱；不符合時必須請使用者修正或授權轉換後的新名稱。 - 不產生 `TODO`、待辦事項、checklist、工作清單或實作任務；計畫頁只描述系統規劃、決策、範圍、方案、風險與待確認事項。 @@ -135,7 +135,7 @@ API 寫入方式： - 建立新頁：`POST /repos///wiki/new`，body 帶 `title`、`content`、`message`。 - 更新既有頁：先查表取得 `sub_url`，再用 `PATCH /repos///wiki/page/`，body 帶 `title`、`content`、`message`。 -- request body 必須由工具呼叫或記憶中內容直接送出，不得先寫成本機 JSON 或 Markdown 檔。 +- request body 必須由工具呼叫、stdin、shell 變數或記憶中內容直接送出，不得先寫成本機 JSON、Markdown 或任何暫存檔；禁止所有 `@file` 形式。 - message 用繁體中文，例如 `更新 `。 若站台不支援 REST wiki 寫入端點，回報「此站台不支援不落地 wiki 寫入」並停止，不得改用 wiki git clone。 diff --git a/skills/todo-wiki/SKILL.md b/skills/todo-wiki/SKILL.md index 26f4cb5..a139f35 100644 --- a/skills/todo-wiki/SKILL.md +++ b/skills/todo-wiki/SKILL.md @@ -1,12 +1,12 @@ --- name: todo-wiki -description: 把「需求 → 分析 → 產生鎖定模型的 TODO 清單 → 同步到 Gitea wiki 目錄與頁面」固定成不落地檔案的流程：先依 `/jsc-shared:spec-model` 的「需求分析」任務挑出分析模型，當前模型不符就停止；接著讀取來源（需求描述、本機檔案，或走 `/jsc-shared:spec-issue-read` 讀取的 Gitea 議題）並釐清需求，任何不清楚之處依 `/jsc-shared:spec-ask-user` 詢問；再依「依清單實作」任務挑出實作模型或採用使用者指定；最後把帶 `model`／`model_alias`／`model_reason`／`analyzed_by`／`analyzed_at`／`scope` frontmatter 與強制規則區塊的 TODO 內容直接同步到指定 Gitea wiki 目錄頁與 todo 頁。當使用者說要把需求整理成 wiki TODO、同步 todo 到 Gitea wiki、需求轉 todo-wiki、指定模型 todo wiki、或提到 todo-wiki skill 時觸發。不適用於：產生本機 todo.md、把需求拆分成多個 Gitea 議題（用 `/jsc-doc:issues-analyze`）、實作既有 Gitea 議題的 TODO（用 `/jsc-code:issues`）。 +description: 把「需求 → 分析 → 產生鎖定模型的 TODO 清單 → 同步到 Gitea wiki 目錄與頁面」固定成禁止本機檔案落地的流程：先依 `/jsc-shared:spec-model` 的「需求分析」任務挑出分析模型，當前模型不符就停止；接著讀取來源（需求描述、本機檔案，或走 `/jsc-shared:spec-issue-read` 讀取的 Gitea 議題）並釐清需求，任何不清楚之處依 `/jsc-shared:spec-ask-user` 詢問；再依「依清單實作」任務挑出實作模型或採用使用者指定；最後把帶 `model`／`model_alias`／`model_reason`／`analyzed_by`／`analyzed_at`／`scope` frontmatter 與強制規則區塊的 TODO 內容直接同步到指定 Gitea wiki 目錄頁與 todo 頁。當使用者說要把需求整理成 wiki TODO、同步 todo 到 Gitea wiki、需求轉 todo-wiki、指定模型 todo wiki、或提到 todo-wiki skill 時觸發。不適用於：產生本機 todo.md、把需求拆分成多個 Gitea 議題（用 `/jsc-doc:issues-analyze`）、實作既有 Gitea 議題的 TODO（用 `/jsc-code:issues`）。 argument-hint: "[--source <需求描述|檔案路徑|議題編號>] [--impl-model ] [--wiki-repo ] [--wiki-index CONTENTS] [--wiki-project <關聯計畫或系統名稱>] [--wiki-page TODO--] [--append|--overwrite] [--yes]" --- # todo-wiki — 需求分析並同步指定模型 TODO 到 Gitea wiki -把「需求 → 分析 → 產生 TODO wiki 頁 → 交給指定模型實作」固定成七個階段。全程不建立本機 `todo.md`、草稿檔、暫存 JSON body 或 wiki clone；唯一輸出位置是指定 Gitea wiki。 +把「需求 → 分析 → 產生 TODO wiki 頁 → 交給指定模型實作」固定成七個階段。全程禁止本機檔案落地；唯一輸出位置是指定 Gitea wiki。 | 階段 | 做什麼 | 產出 | | --- | --- | --- | @@ -26,8 +26,8 @@ argument-hint: "[--source <需求描述|檔案路徑|議題編號>] [--impl-mode 本 skill 特有補充： -- **不落地絕對規則**：不得建立或更新本機 `todo.md`、`.md` 草稿、暫存 JSON body、wiki clone、或任何用來傳遞中間成果的檔案；中間成果只存在於對話內容與 Gitea wiki API request body。不得使用 `curl --data @file`。 -- `--source` 指向本機檔案時可以唯讀讀取來源檔；這不是輸出落地。`--source` 指向 Gitea 議題附件時，僅可依 `spec-issue-read` 的附件唯讀暫存例外讀取，讀完立即刪除。 +- **不落地絕對規則**：全程禁止本機檔案落地。不得建立、更新、下載或暫存任何本機輸出／中介檔案，包含 `todo.md`、`plan.md`、`.md` 草稿、暫存 JSON body、附件暫存檔、wiki clone、或任何用來傳遞中間成果的檔案；中間成果只存在於對話內容、工具參數與 Gitea wiki API request body。不得使用 `curl --data @file`、`--data-binary @file` 或任何 `@file` 形式送出本機檔案。 +- `--source` 指向本機既有檔案時可以唯讀讀取來源檔；這不是輸出落地，不得修改該來源檔或寫出衍生檔。`--source` 指向 Gitea 議題附件時，只能以 API／工具直接讀入記憶；若附件必須下載成暫存檔才能讀取，立刻停止並回報「附件需要檔案落地，違反本 skill 不落地規則」。 - 本 skill 產生的 wiki todo 頁就是 `spec-model` 第六節所述「帶 `model:` frontmatter 的清單檔」的源頭；本 skill 只負責產生與同步清單，不執行清單內容。 - 階段 1 的模型檢查針對「執行本 skill 分析工作的 agent 自己」；階段 3 選出的實作模型是寫進 wiki 頁給未來另一個 session 用。 - 目標 wiki repo 不明時必須詢問；不得因為目前工作目錄是某 repo 就臆測 wiki 目標。 @@ -168,7 +168,7 @@ API 寫入方式： - 建立新頁：`POST /repos///wiki/new`，body 帶 `title`、`content`、`message`。 - 更新既有頁：先查表取得 `sub_url`，再用 `PATCH /repos///wiki/page/`，body 帶 `title`、`content`、`message`。 -- request body 必須由工具呼叫或記憶中內容直接送出，不得先寫成本機 JSON 或 Markdown 檔。 +- request body 必須由工具呼叫、stdin、shell 變數或記憶中內容直接送出，不得先寫成本機 JSON、Markdown 或任何暫存檔；禁止所有 `@file` 形式。 不得自行猜測 Gitea wiki title 到 `sub_url` 的轉義規則；找既有頁一律查表。若 REST wiki 寫入端點不可用，回報「此站台不支援不落地 wiki 寫入」並停止，不得改用 wiki git clone。