Communitygithub.com

duncan-buildroom/freeskills

設定兩個復原系統,讓你無後顧之憂地進行實驗——/rewind 即時復原、Git 檢查點永久儲存。引導你為當前專案建立第一個檢查點,並儲存一份包含「搞砸了」、「回退一步」、「回到今天早上」等復原操作的一頁速查表。

freeskills 是什麼?

這個名為「Safety Net」的技能旨在消除初學者在開發時對搞壞專案的恐懼,透過設定兩個互補的復原系統來賦予他們實驗的信心。第一個是 `/rewind`,它由 Claude Code 自動在每次變更前建立快照,適合快速回退最近的操作;第二個是 Git 檢查點,需要使用者手動觸發,能永久儲存專案在某個時間點的完整狀態。技能會引導使用者在當前專案中實際建立第一個檢查點,並將一份包含三種常見情境(搞砸了、回退一步、回到之前正常狀態)復原腳本的速查表儲存到 `~/claude-safety-net.md`。它主要適用於 Claude Code 平台,特別針對那些因為害怕破壞專案而不敢嘗試新功能的開發者。技能強調實際操作而不是理論說明——使用者的恐懼只有透過親自使用 `/rewind` 復原一次變更、並建立一個檢查點才能消除。整個過程不需要使用者輸入任何原始 Git 指令,所有操作透過自然語言完成。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/duncan-buildroom/freeskills/tree/HEAD/safety-net

在你喜歡的 AI 中提問

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

說明文件

Safety Net — 兩種復原,讓你放心實驗

初學者會因為以為一個糟糕的提示就會毀掉一切而不敢大膽建造。但其實不會。你有兩個獨立的復原系統,一旦設定好,你就可以嘗試那些原本會避免的事情。這個技能會解釋兩者,為你實際的專案建立第一個真正的檢查點,並留下一份你可以隨時參照的速查表。

設定

無。這個技能開箱即用。

步驟

1. 說出他們需要聽到的話

直接開門見山地說:「你其實搞不壞任何東西。這裡有兩個復原按鈕,而且等這一步結束,你這個專案上兩個都會正常運作。」

然後說出兩者的名稱,並說明它們的差異——這是所有人都容易混淆的部分:

  • /rewind — 自動、即時、短期。Claude Code 在每次變更前都會自動拍一張快照。你不需要設定,也不用動手。它適用於「你最後做的那件事讓情況變得更糟了」。
  • Git 檢查點 — 手動、永久、長期。你說「把這個版本當成檢查點提交」,專案的那個精確狀態就會永遠以一個名稱儲存下來。它適用於「把我恢復到星期二它還能正常運作時的狀態」。

一句話記住重點:rewind 復原動作,檢查點保存日子。

2. 正確教導 /rewind

只涵蓋這些,不用多講:

  • 在 Claude Code 中輸入 /rewind。你會看到最近檢查點的清單。
  • 更快的方法是:在空的輸入框中按兩次 Esc。效果相同。
  • 選擇出問題之前的時間點。你的檔案就會回到那個狀態。
  • 它是自動的——無論你是否要求,每次變更前都會發生。
  • 它做不到的事:它只適用於同一個工作階段的近期操作,不能用來回退好幾天前的狀態。那是檢查點的工作。

然後讓他們實際試一次。說:「請 Claude 做一個小小的無意義變更——把某個標題改成 BANANA 這個字。看一下結果。然後輸入 /rewind 把它改回來。」實際做一次就能永久消除恐懼。光用讀的是做不到的。

3. 檢查這個專案是否已設定 Git

詢問他們正在處理哪個專案,並取得資料夾路徑。檢查它是否已經是 Git 倉儲——尋找裡面的 .git 資料夾。

不要把 Git 當作版本控制系統來解釋。把它解釋成:「一種用名稱儲存整個專案永久快照的方法,這樣你隨時都可以回到那個狀態。」

如果還沒設定,你就幫他們設定。他們說一句話,你來執行指令。絕對不要把一串 Git 指令交給初學者自己去打。

4. 立刻建立他們的第一個檢查點

這一步必須實際發生,而不是只有描述。

讓他們對 Claude 說:「把這個版本當作檢查點提交,取名為『開始實驗前的正常運作版本』。」

你來處理剩下的事。然後大聲確認剛剛發生的事:「你的專案現在已經永久儲存了那個狀態。無論你接下來做什麼,你都可以回到完全相同的這個狀態。」

那句話就是整個技能的核心。

5. 養成建立檢查點的習慣

告訴他們三個應該建立檢查點的時機。就三個,不是十個:

  • 當某個東西可以運作時。 在頁面正確載入或功能正常運作的那一刻。在你再次動它之前。
  • 在進行有風險的操作之前。 大型改版、新功能、任何你不確定的事情。
  • 每次工作階段結束時。 關上筆電前的一部分——在 90 分鐘的工作時間中,最後 10 分鐘是用來建立檢查點加上寫下明天要做的下一步(一行就好)。

告訴他們如何為檢查點命名:說出專案所處的狀態,而不是你做了什麼。「行動版首頁運作正常」比「變更」好。

6. 寫下三種復原操作

這三種是他們實際上會遇到的情況。把它們寫成可以照著唸的腳本。

「我搞砸了,而且不知道怎麼搞的。」 不要急著除錯。輸入 /rewind,或按兩次 Esc。選擇出問題之前的時間點。然後用更小的步驟重新提出你原本想要的功能。

「回退一步。」 輸入 /rewind,選擇最近的檢查點。或者對 Claude 說:「復原你最後做的變更。」

「回到今天早上/回到它還能運作的時候。」 對 Claude 說:「顯示我今天建立的檢查點。」選取一個。然後說:「把專案回復到名為 ___ 的檢查點。」Rewind 無法回溯那麼遠——這就是檢查點的用途。

加上緊急逃生口:「我想要舊版回來,但也想保留我之後做的東西。」 對 Claude 說:「把我現在有的東西儲存成一個檢查點,然後帶我回到 ___。」這樣什麼都不會遺失。

輸出 — 儲存起來

寫入 ~/claude-safety-net.md。一頁就好,不能再長——這是速查表,不是操作手冊。

內容包含:兩個系統的一句話區別、/rewind 操作(含 Esc-Esc)、建立檢查點的確切句子、三個建立檢查點的時機、三種復原腳本的完整內容、「保留兩版」的逃生口,以及他們剛建立的第一個檢查點的名稱和日期。

告訴他們路徑,然後給他們一個動作:在開發時把這個檔案開在一個分頁裡。也告訴他們一個事實——既然兩種復原系統都已經就緒,正確的下一步就是去嘗試那些之前因為緊張而不敢嘗試的事情。

範例(輸入 → 輸出)

輸入:「我正在做我的作品集網站,我想嘗試一個完全不同的版面,但我怕會弄丟現在這個可以正常運作的版本。」

輸出(儲存到 ~/claude-safety-net.md):

你的兩種復原
Rewind 復原動作。檢查點保存日子。

REWIND — 即時、自動
輸入 /rewind,或在空白輸入框按兩次 Esc。
選擇出問題之前的時間點。檔案就會回復。
只適用於近期操作,不適合同退好幾天。

CHECKPOINT — 永久、你需要主動要求
說:「把這個版本當作檢查點提交,取名為『<目前狀態>』。」
在功能正常時、進行有風險操作前、以及每次工作階段結束時建立。

你的第一個檢查點
「作品集在版面實驗前可正常運作」——儲存於 2026-07-30。
你隨時可以回到這個狀態。

如果我搞砸了
不要除錯。/rewind,選擇出問題之前的時間點,用更小的步驟重新嘗試。

回退一步
/rewind 並選擇最近的檢查點。或者:「復原你最後做的變更。」

回到它還能運作的時候
「顯示我今天建立的檢查點。」
「把專案回復到名為 ___ 的檢查點。」

保留兩個版本
「把我現在有的東西儲存成一個檢查點,然後帶我回到 ___。」

下一步行動:去試試新的版面。舊版已經儲存好了。

備註/邊緣情況

  • 這個技能要預防的失敗是「膽怯建造」——初學者因為守護著一個正常運作的版本而避開有趣的嘗試。檢查點的全部意義就是給予實驗的許可。
  • 一定要讓她們實際在第 2 步做一次 rewind 測試,並在第 4 步實際建立檢查點。一個只描述安全網的技能無法創造擁有安全網的感受。
  • 絕對不要把原始的 Git 指令交給她們。她們說一句話,Claude 來執行。如果她們以後想好好學習 Git,那是另一天的任務。
  • 如果專案還沒有 Git 倉儲,就順便幫她們設定好,不用大張旗鼓。只是一個步驟,沒有任何成本,而且只要 10 秒鐘。
  • 如果她們已經搞砸了某個東西,先用第 6 步處理,之後再設定其他的東西。先滅火,再裝警報器。
  • 如果她們盯著一個錯誤訊息,不確定是否該 rewind,轉交給 error-decoder——它會將錯誤分類為忽略、修復或 rewind。

相關技能