plugins/shared
2
0
Fork 0
Code Pull Requests Activity

feat(todo 清單完成追蹤): 新增「完成即勾選」強制規則與時間戳慣例

Browse Source 
todo skill 產生的強制規則區塊新增第五條規則：完成一項就地勾選並附上 Asia/Taipei 時間戳，不得留待多項一起補勾。spec-todo-list 同步補上對應的完成回報時間戳慣例，避免兩處規範各自漂移。
This commit is contained in:
jiantw83
2026-08-12 05:52:53 +00:00
parent 44bd526dbd
commit 8f09285545
2 changed files with 5 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/spec-todo-list/SKILL.md
+2 -1
View File
@@ -1,6 +1,6 @@
--- ---
name: spec-todo-list name: spec-todo-list
description: JSC plugins 共用「TODO list 規範」：一律用 Markdown checklist（`- [ ]`）格式、每項要具體到可執行可驗收、不得憑空編造需求外的項目、依影響範圍由小到大排序、每項要能舉證對應到 `path:line` 或議題描述的哪一句、完成一項就勾選並留言回報進度。當其他 skill 內文引用 spec-todo-list 或 /jsc-shared:spec-todo-list、或需要產生／追蹤議題（或文件）TODO list 時載入此 skill。單獨被使用者呼叫時，直接說明本規範內容。 description: JSC plugins 共用「TODO list 規範」：一律用 Markdown checklist（`- [ ]`）格式、每項要具體到可執行可驗收、不得憑空編造需求外的項目、依影響範圍由小到大排序、每項要能舉證對應到 `path:line` 或議題描述的哪一句、完成一項就勾選並附上 Asia/Taipei 時間戳並留言回報進度。當其他 skill 內文引用 spec-todo-list 或 /jsc-shared:spec-todo-list、或需要產生／追蹤議題（或文件）TODO list 時載入此 skill。單獨被使用者呼叫時，直接說明本規範內容。
--- ---
# spec-todo-list — 共用 TODO list 規範 # spec-todo-list — 共用 TODO list 規範
@@ -51,5 +51,6 @@ description: JSC plugins 共用「TODO list 規範」：一律用 Markdown check
## 完成回報：勾選並留言 ## 完成回報：勾選並留言
- 完成一項 TODO，就地把該行改成 `- [x]`（子項目全部完成才勾選上層），不得留待多項一起補勾。 - 完成一項 TODO，就地把該行改成 `- [x]`（子項目全部完成才勾選上層），不得留待多項一起補勾。
- 勾選時在行末附上「（完成：yyyy/MM/dd HH:mm:ss）」時間戳，時區與格式依 `/jsc-shared:spec-time-log`（Asia/Taipei）；不得使用其他時區或格式。
- 每完成一項，都要把進度回報成留言（或依所在流程指定的回報位置），內容至少包含：完成了哪一項、對應的 `path:line` 或需求語句依據；多項同時完成時可整理成一則留言，但每一項都要能個別對應到依據。 - 每完成一項，都要把進度回報成留言（或依所在流程指定的回報位置），內容至少包含：完成了哪一項、對應的 `path:line` 或需求語句依據；多項同時完成時可整理成一則留言，但每一項都要能個別對應到依據。
- 無法安全完成的項目保持未勾選，並標註原因（例如「需人工確認」）供後續處理，不得略而不報。 - 無法安全完成的項目保持未勾選，並標註原因（例如「需人工確認」）供後續處理，不得略而不報。
skills/todo/SKILL.md
+3 -2
View File
@@ -96,7 +96,7 @@ scope: <階段 2 產出的 scope>
### 「給執行本清單 Agent 的強制規則」區塊 ### 「給執行本清單 Agent 的強制規則」區塊
固定內容，只代換 `<model>`／`<alias>` 與時間戳，四條規則與錯誤訊息格式**逐字比照**、不可簡化或改寫措辭： 固定內容，只代換 `<model>`／`<alias>` 與時間戳，五條規則與錯誤訊息格式**逐字比照**、不可簡化或改寫措辭：
````markdown ````markdown
## 0. 給執行本清單 Agent 的強制規則（先讀完再動手） ## 0. 給執行本清單 Agent 的強制規則（先讀完再動手）
@@ -107,6 +107,7 @@ scope: <階段 2 產出的 scope>
| **不符就停** | 當前模型 ≠ `<model>` 時，**立刻停止、不做任何檔案修改**，輸出下方錯誤訊息並要求使用者切換。 | | **不符就停** | 當前模型 ≠ `<model>` 時，**立刻停止、不做任何檔案修改**，輸出下方錯誤訊息並要求使用者切換。 |
| **不得自行升降級** | 不可以「先用手上的模型做一點」、不可以自行判定「我這顆更強所以沒關係」。降級與升級同樣禁止。 | | **不得自行升降級** | 不可以「先用手上的模型做一點」、不可以自行判定「我這顆更強所以沒關係」。降級與升級同樣禁止。 |
| **附加不覆蓋** | 若之後要往本檔追加新需求：`model` 相同 → 附加到檔尾；`model` 不同 → 先問使用者是否覆蓋，未得同意不得寫入。 | | **附加不覆蓋** | 若之後要往本檔追加新需求：`model` 相同 → 附加到檔尾；`model` 不同 → 先問使用者是否覆蓋，未得同意不得寫入。 |
| **完成即勾選** | 每完成一項就地把該行的 `- [ ]` 改成 `- [x]`，並在行末附上「（完成：yyyy/MM/dd HH:mm:ss）」（Asia/Taipei，依 `/jsc-shared:spec-time-log`）。**不得留待多項一起補勾**；無法安全完成的項目維持未勾選並標註「需人工確認」，不得略而不報。 |
``` ```
[<yyyy/MM/dd HH:mm:ss>][模型檢查][ERR]: 本清單指定 <model>（<alias>），當前模型為 <current-model-id>。 [<yyyy/MM/dd HH:mm:ss>][模型檢查][ERR]: 本清單指定 <model>（<alias>），當前模型為 <current-model-id>。
@@ -118,7 +119,7 @@ scope: <階段 2 產出的 scope>
### checklist（依 `/jsc-shared:spec-todo-list` 排序與具體化） ### checklist（依 `/jsc-shared:spec-todo-list` 排序與具體化）
- 逐項 `- [ ] **編號 短標題**：具體內容`，內容需動詞＋對象＋驗收條件齊備，能舉證對應 `path:line` 或需求彙整中的哪一句。 - 逐項 `- [ ] **編號 短標題**：具體內容`，內容需動詞＋對象＋驗收條件齊備，能舉證對應 `path:line` 或需求彙整中的哪一句。完成後改為 `- [x] **編號 短標題**：具體內容（完成：yyyy/MM/dd HH:mm:ss）`，依上方「完成即勾選」規則逐項就地更新，不得留待多項一起補勾。
- 依影響範圍由小到大排序（XS/S/M/L/XL，見 `spec-todo-list`），範圍相同時前置依賴排前面。 - 依影響範圍由小到大排序（XS/S/M/L/XL，見 `spec-todo-list`），範圍相同時前置依賴排前面。
- **編號規則**：清單有自然的分組（例如多個獨立工作方向）時，用「群組代號＋序號」（如 `A0-1`、`B1-2`，仿本檔範例）；沒有分組時用整數流水號（`1`、`2`、`3`…）。日後附加新項目時，編號延續既有規則、不得重複或跳號造成混淆。 - **編號規則**：清單有自然的分組（例如多個獨立工作方向）時，用「群組代號＋序號」（如 `A0-1`、`B1-2`，仿本檔範例）；沒有分組時用整數流水號（`1`、`2`、`3`…）。日後附加新項目時，編號延續既有規則、不得重複或跳號造成混淆。
- 清單分成多個彼此有先後依賴的群組時，仿照本檔範例在 checklist 前加一段「### 執行順序」註明群組間的強制先後與理由；若清單本身沒有這種分階段結構，省略此小節即可，不必為了套版而硬分組。 - 清單分成多個彼此有先後依賴的群組時，仿照本檔範例在 checklist 前加一段「### 執行順序」註明群組間的強制先後與理由；若清單本身沒有這種分階段結構，省略此小節即可，不必為了套版而硬分組。