Community程式設計與開發github.com

BreakingGap

在AI代理工作時,提供一個簡短的工具性空檔,讓人類能完成一個有用的小步驟,例如決策、短稿或學習,並確保能輕鬆返回主線任務。

BreakingGap 是什麼?

BreakingGap 是一個專為 AI 代理工作流程設計的技能,目的在於填補代理執行任務時的人類空檔時間。它能根據當前對話和專案狀態,推薦一個可在 10 分鐘內完成的小步驟,例如推進當前工作、接續未完成的任務,或學習一個概念。此技能支援所有主流對話平台(如 Claude Code、Cursor 等),無需安裝 Python 或額外工具即可純聊天使用,但也提供可選的本地輔助腳本與離線計時器介面。其核心機制是先確認使用者給定的時間預算,再估算設定、人類操作與結尾時間,並保留 2 分鐘緩衝以確保順利返回主線任務。建議始終優先檢查代理是否已完成或需要人類介入,避免假設代理狀態。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/m1nga/breakinggap/tree/HEAD/skills/breakinggap

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

BreakingGap 是做什麼的?

一點空檔,多一點進展。

在代理工作時,幫助人完成一個小而有意義的貢獻。結果可能是一個更明確的決策、幾句有用的文字、一個重拾的想法,或一個更清楚理解的概念。留空空檔也是一個有效的選擇。使用對話的語言;內附的配套介面為英文。

找到一個屬於這裡的步驟

首先使用當前對話和專案的現有狀態。保持主要工作和其返回點可見。僅透過可用且經授權的狀態工具或使用者的報告來檢查代理的當前狀態;切勿虛構即時監控。如果主要代理需要此人或已完成,請在提出其他活動前先返回其結果。

使用使用者陳述的時間預算。如果未提供,請提出一個關於可用時間和當前工作的簡短問題;不要假設代理的預計完成時間為十分鐘。如果持續時間不確定,請提供一個有明確估計、易於中斷的兩分鐘步驟。不要為了找到建議而啟動大型掃描或等待所有代理完成。

從請求推斷有用的意圖;否則優先考慮當前工作:

  • 推進此工作: 一個人類判斷、接受範例、短文草稿或比較,在不依賴待處理輸出的情況下改進當前工作。
  • 接續某事: 一個已授權的未完成項目,並有具體保存的下一個動作。重新檢查該項目是否仍處於開放狀態;不要復活已暫停的工作或其他負責人的任務。
  • 學習一件事: 一個來自當前專案中真實來源的概念。請使用者預測、解釋或比較,然後提供簡短的源頭驗證。沒有回應表示沒有展示學習。誠實標記生成的範例和未解決的問題。

只讀取足夠的當前原始碼以支援所選動作。確認它仍然有用、已授權、獨立於待處理輸出,且與進行中的工作無衝突。不要將小任務視為越過暫停點、更改代理擁有的檔案、發送訊息或發佈的許可。優先使用私人草稿回應而非並行編輯。如果缺少上下文,請詢問當前目標或使用使用者提供的文字;切勿虛構待辦事項、原始碼位置、完成狀態或授權。

估計設定 + 人類操作 + 結尾時間,並在使用者的預算內保留兩分鐘用於返回。估計值不是測量的持續時間或代理完成預測。將過大的工作縮減到一個有意義的停止點;排除不明確或深度吸引人的任務,而不是將未知工作量預設為一個方便的數字。

提供一個小步驟

在一個緊湊的對話卡片中給出一個建議:

試試看: 一個具體的動作,第一步要明確。 為什麼適合: 與使用者工作或好奇心的連結;估計的設定/操作/結尾時間和返回緩衝。 到此為止: 小成果或答案,以及一個安全的停止點。 返回: 主要工作和恢復點。

命名或連結實際來源。使用使用者的上下文而非通用的生產力建議。如果要求不同的步驟,請替換建議;不要一次列出長長的佇列。可選的趣味限制可以使動作更具吸引力(「用三句話解釋」、「試試兩個標題」),前提是它適合工作。不要添加連續記錄、緊迫感、虛構成就或填滿每個空檔的壓力。

讓人類執行人的步驟。不要默默地完成他們的學習練習或啟動另一個自主工作流程。在使用者現有授權內執行所請求的協助。如果沒有適合的,簡短說明並讓空檔保持開放。

乾淨地停止並返回

當使用者表示代理已準備好或想停止時,優先返回。保留對話中已有的任何工作;如有需要,請要求一個簡短的「我進行到哪裡 / 下一步」筆記,但切勿將其作為返回前的門檻。空檔計時器到期並不表示代理已完成。

分別記錄實際工作和計劃工作。當更新獲得授權時,重複使用專案的一般筆記;一個會話檢查點並不表示一個正規任務已完成。僅在成功寫入後才說「已儲存」。如果儲存失敗,請在聊天中提供筆記並說明其仍未儲存。恢復時,在再次提供已儲存的步驟之前,重新讀取相關來源和當前狀態。

可選的本地工具

純聊天使用不需要 Python、帳戶、任務資料夾、整合或配套程式。保持使用者的輸入和現有專案記錄的權威性。

對於可重複的檔案式選擇和可恢復的本地會話,請使用內附的標準函式庫輔助程式。閱讀 references/session-format.md 以了解其確切輸入和命令。輔助程式從實際證據構建其 JSON;切勿要求使用者管理內部欄位。通過其絕對路徑執行已安裝的 scripts/gap.py,並使用 --root 指向使用者的現有專案,而非此安裝位置。輔助程式會檢查原始碼雜湊和提供的資格斷言;它無法獨立證明所有權、權限、狀態或不存在衝突。請在開始前重新檢查這些。

可選的離線配套程式提供計時器和檢查點流程。將 assets/logo.png 放在其旁邊開啟。它以明顯虛構的範例開始。若要使用真實工作,輔助程式可以從授權的本地來源準備 schema-1 輸入包並匯入。該頁面可以驗證提供的欄位,但無法重新讀取專案檔案、驗證雜湊、監控代理或與輔助程式日誌同步。其本地瀏覽器儲存和匯出是獨立副本。檢查點匯出是在檢查當前來源後進行調解的證據,絕非執行指令。如果 Python 或瀏覽器儲存不可用,請在聊天中繼續或導出筆記;不要僅僅為了使用此技能而安裝依賴項。

相關技能