caveman-compress

Caveman Compress

目的

將自然語言檔案（CLAUDE.md、待辦事項、偏好設定等）壓縮為精簡的原始人語法（caveman-speak），以減少輸入 token。壓縮版本會直接覆蓋原始檔案，並自動儲存一份易於閱讀的備份檔 <filename>.original.md。

觸發條件

使用指令 /caveman-compress <檔案路徑>，或當使用者要求「壓縮記憶檔案」時。

處理流程

1. 壓縮腳本部位於 scripts/ 目錄中（與本 SKILL.md 相鄰）。若無法直接取得該路徑，請在 SKILL.md 旁搜尋 scripts/__main__.py。

2. 在包含本 SKILL.md 的目錄下執行：

python3 -m scripts <absolute_filepath>

3. CLI 將會：

• 偵測檔案類型（不消耗 token）
• 呼叫 Claude 進行壓縮
• 驗證輸出內容（不消耗 token）
• 若出現錯誤：使用 Claude 進行針對性修復（僅進行局部修復，不重新壓縮）
• 最多重試 2 次
• 若重試 2 次後仍失敗：向使用者回報錯誤，並保持原始檔案不變

4. 將結果傳回給使用者

壓縮規則

刪除

• 冠詞：a, an, the
• 贅詞：just, really, basically, actually, simply, essentially, generally
• 客套話："sure"、"certainly"、"of course"、"happy to"、"I'd recommend"
• 模稜兩可的詞句："it might be worth"、"you could consider"、"it would be good to"
• 冗長表達："in order to" → "to"、"make sure to" → "ensure"、"the reason is because" → "because"
• 冗餘轉折詞："however"、"furthermore"、"additionally"、"in addition"

嚴格保留（絕不修改）

• 程式碼區塊（圍欄 ``` 與縮排區塊）
• 行內程式碼（反引號內容）
• URL 與連結（完整 URL、Markdown 連結）
• 檔案路徑（/src/components/...、./config.yaml）
• 指令（npm install、git commit、docker build）
• 技術術語（函式庫名稱、API 名稱、通訊協定、演算法）
• 專有名詞（專案名稱、人名、公司名稱）
• 日期、版本號、數值
• 環境變數（$HOME、NODE_ENV）

保留結構

• 所有 Markdown 標題（保持標題文字完全一致，僅壓縮下方內文）
• 項目符號階層（保留縮排與內嵌層級）
• 編號清單（保留數字序號）
• 表格（壓縮儲存格文字，保留表格結構）
• Markdown 檔案中的 Frontmatter / YAML 標頭

進行壓縮

• 使用同義簡短詞彙：用 "big" 代替 "extensive"，用 "fix" 代替 "implement a solution for"，用 "use" 代替 "utilize"
• 可使用簡短片段語句：寫 "Run tests before commit"，而非 "You should always run tests before committing"
• 省略 "you should"、"make sure to"、"remember to" 等句型 — 直接陳述動作即可
• 合併以不同方式表達相同概念的冗餘清單項目
• 當有多個範例展示相同模式時，僅保留一個範例

關鍵規則：
所有位於 ... 內的內容必須「完全原樣複製」。
切勿：

• 刪除註解
• 刪除空格或空行
• 調整行順序
• 縮短指令
• 簡化任何內容

行內程式碼（...）必須「完全保留原樣」。
切勿修改反引號內的任何內容。

若檔案包含程式碼區塊：

• 將程式碼區塊視為唯讀區域
• 僅壓縮程式碼區塊之外的文字
• 切勿跨程式碼區塊合併前後章節

模式範例

原文：

You should always make sure to run the test suite before pushing any changes to the main branch. This is important because it helps catch bugs early and prevents broken builds from being deployed to production.

壓縮後：

Run tests before push to main. Catch bugs early, prevent broken prod deploys.

原文：

The application uses a microservices architecture with the following components. The API gateway handles all incoming requests and routes them to the appropriate service. The authentication service is responsible for managing user sessions and JWT tokens.

壓縮後：

Microservices architecture. API gateway route all requests to services. Auth service manage user sessions + JWT tokens.

範圍與界限

• 僅壓縮自然語言檔案（.md、.txt、.typ、.typst、.tex 及無副檔名檔案）
• 絕不修改：.py、.js、.ts、.json、.yaml、.yml、.toml、.env、.lock、.css、.html、.xml、.sql、.sh
• 若檔案包含混合內容（敘述文字 + 程式碼），僅壓縮敘述文字部分
• 若不確定某段內容屬於程式碼或敘述文字，請保持原樣不作更動
• 在覆蓋原始檔案前，原始檔案會先備份為 FILE.original.md
• 切勿壓縮 FILE.original.md（直接跳過該檔案）