循環如何運作
- 你提供任務(行內文字、現有筆記 UUID,或繼續)
- 建立一則綠色釘住筆記,帶核取方塊
- Claude 開始執行第一個任務
- Stop hook 攔截 Claude 的結束動作,並載入下一個任務
- 每完成一個任務,就自動在 SlashNote 裡打勾
- 重複直到所有任務完成,或你暫停/停止
Stop hook 是關鍵機制 — 還有任務時,它會擋住 Claude 結束。
模式
新任務(行內)
/note-loop 寫測試、實作功能、更新文件
建立一則綠色釘住筆記,帶核取方塊,並立刻開始執行。
從現有筆記(UUID)
/note-loop A550DE30-9B73-4CE5-A138-38F848471329
讀取現有筆記裡未勾選的核取方塊並開始執行。
排程稍後(新終端機)
/note-loop <uuid> --new-session 2h
/note-loop <uuid> --new-session --sonnet
以指定的延遲開啟新的終端機會話。可選擇模型(Opus、Sonnet、Haiku)與權限模式(plan、acceptEdits、bypassPermissions)。
繼續
/note-loop
找到現有的 note-loop 筆記,從未勾選的項目繼續。
循環控制
| 指令 | 效果 |
|---|---|
/note-loop pause | 立即暫停 — 之後用 /note-loop 繼續 |
/note-loop pause after | 優雅暫停 — 完成目前任務後停下 |
/note-loop skip <原因> | 帶原因跳過目前任務,進到下一個 |
/note-loop stop <原因> | 完全停止循環,顯示最終摘要 |
/note-loop list | 列出所有進行中/已排程的循環 |
/note-loop cancel <uuid> | 取消一個已排程的循環 |
每個暫停/停止動作都會顯示進度摘要:完成、跳過、剩餘,附完成百分比。
安全機制
| 安全項 | 說明 |
|---|---|
| 最大迭代次數 | max(30, tasks * 3) — 隨任務數量調整 |
| 每任務嘗試次數 | 3 次後標記為 blocked |
| 暫停/停止 | 隨時 /note-loop pause 或 /note-loop stop |
| 狀態檔 | JSON 狀態能撐過會話重啟 |
| 被擋住的任務 | 維持未勾選,待手動追蹤 |
進度追蹤
釘住筆記上的即時進度圖會顯示:
- 完成的任務(綠色)
- 剩餘的任務(灰色)
當 Stop hook 處理每個任務時,圖表會自動更新。
排程選單
使用 --new-session 但不指定時間時,會出現一個選單:
| 選項 | 說明 |
|---|---|
| 現在執行 | 開啟新終端機並立刻開始 |
| 1 分鐘後 | 短延遲,方便確認設定 |
| 30 分鐘後 | 先完成目前的工作 |
| 2 小時後 | 排程稍後 |
你也可以輸入自訂時間(1h 30m、at 18:00)。
智慧目錄偵測
在新終端機會話排程循環時,這個 skill 會自動偵測工作目錄:
- 真實目錄(例如
/Users/you/project)會直接使用 - 虛擬目錄(例如
/code、Docker 路徑)會被偵測並拒絕 - 如果無法判斷目錄,SlashNote 會開啟一個可編輯的設定面板,讓你手動設定目錄
這確保新的終端機會話永遠在正確的專案根目錄執行。
現有設定
如果筆記已經有排程設定(來自先前的 /note-loop 執行),這個 skill 會重複使用它:
- 目錄、模型與權限模式都會保留
- 開始前你可以在設定面板裡編輯任何欄位
- 設定面板會顯示目前的設定供你檢視
狀態檔
循環狀態存在 .claude/slashnote-loop.local.md(JSON 格式)。這個檔案追蹤:
- 進行中狀態、目前任務索引
- 已完成與被擋住的任務清單
- 迭代計數與上限
- 暫停/停止的原因與時間戳記