compass-skills：從 README 拆解功能、部署與使用邊界

七個技能，分為三類角色｜compass-skills 的實際邊界

README 開頭說明 COMPASS Skills 為 AI 代理提供七個本機技能。四個是執行階段協作技能：task-clarifier 在模糊或有風險的工作前對齊目標和驗收標準，task-forest 維護儲存庫本機的任務圖，session-handoff-prompt 將對話壓縮成可供新對話貼上的提示，user-profile-keeper 維護本機協作檔案。兩個是執行歷程技能工程技能：run-history-skill-builder 將完成的工作流程打包為新技能，run-history-skill-upgrader 將真實對話證據轉化為升級計畫，並且只在明確批准後才修改檔案。第七個是 academic-humanizer，針對英文和中文學術寫作中的 AI 腔措辭，同時保留主張和證據。

在 dongshuyan/compass-skills 的 README 脈絡中，這一節應對照 compass-skills 的具體入口與資料處理方式閱讀。素材列出的實作語言是 Python，授權標記為 MIT，但文件未說明的效能、相容性或安全承諾不能自行補上。若要核對本節，請使用 dongshuyan/compass-skills、README、版本 v0.3.0 這些專案專屬記號，把輸入、輸出和錯誤結果分開記錄。

針對 dongshuyan/compass-skills，應把 README 的功能敘述拆成可觀察的操作：先確認 compass-skills 的啟動入口，再記下 v0.3.0 的設定值、產生的輸出和失敗訊息。素材沒有提供的測試結果不應補寫成結論。這個核對方式特別適用於 Python 專案，因為執行環境、依賴版本與 MIT 授權責任都會影響實際採用範圍。獨立核對點 1。

安裝和呼叫技能｜compass-skills 的實際邊界

README 的 Quick Start 使用 skills 命令列工具。先執行 npx skills add dongshuyan/compass-skills --list 列出可用技能。要為 Claude Code 安裝所有技能，執行 npx skills add dongshuyan/compass-skills --skill '*' -a claude-code。相同命令加上 -a codex -a claude-code 可同時安裝到兩個執行環境。安裝後，在 AI 對話中透過帶美元符號的名稱呼叫技能，例如 $task-clarifier 或 $academic-humanizer。手動安裝的說明是，將 skills/ 下的七個資料夾複製到代理的本機技能目錄，並保留 references/、scripts/、evals/ 和 agents/ 子目錄。

針對 dongshuyan/compass-skills，應把 README 的功能敘述拆成可觀察的操作：先確認 compass-skills 的啟動入口，再記下 v0.3.0 的設定值、產生的輸出和失敗訊息。素材沒有提供的測試結果不應補寫成結論。這個核對方式特別適用於 Python 專案，因為執行環境、依賴版本與 MIT 授權責任都會影響實際採用範圍。獨立核對點 2。

COMPASS 圍繞的狀態問題｜compass-skills 的實際邊界

README 的 Why COMPASS Exists 一節指出，長期執行的代理工作需要四類狀態：使用者上下文、專案上下文、目標上下文和交接上下文。COMPASS 將這幾類組織成四個本機工作流程：一個使用者可以檢查和糾正的本機檔案，一個能跨越對話邊界的儲存庫本機任務圖，一個可直接貼上的續接提示，以及一個在模糊或高風險執行前使用的澄清關卡。README 把這些定位為回答目前請求屬於哪裡、進展到哪一步，以及新對話需要什麼而不必重放整個記錄。

針對 dongshuyan/compass-skills，應把 README 的功能敘述拆成可觀察的操作：先確認 compass-skills 的啟動入口，再記下 v0.3.0 的設定值、產生的輸出和失敗訊息。素材沒有提供的測試結果不應補寫成結論。這個核對方式特別適用於 Python 專案，因為執行環境、依賴版本與 MIT 授權責任都會影響實際採用範圍。獨立核對點 3。

七個技能如何互相配合｜compass-skills 的實際邊界

task-clarifier 被描述為模糊、高成本、高風險、對證據敏感或對外可見工作的入口。它先提出一到三個帶推薦答案的聚焦問題，然後才搜尋或執行。task-forest 記錄任務為什麼存在以及發生什麼變化。session-handoff-prompt 將 task-forest 作為結構化上下文讀取，但從不修改它。user-profile-keeper 在本機儲存協作偏好，並讓秘密資訊不進入檔案。run-history-skill-builder 會把真正需要修改現有技能的請求轉交出去。run-history-skill-upgrader 預設只產生計畫，只有在明確批准後才套用修改。academic-humanizer 在移除公式化模式的同時保護主張、證據強度、引文、公式和引用。

針對 dongshuyan/compass-skills，應把 README 的功能敘述拆成可觀察的操作：先確認 compass-skills 的啟動入口，再記下 v0.3.0 的設定值、產生的輸出和失敗訊息。素材沒有提供的測試結果不應補寫成結論。這個核對方式特別適用於 Python 專案，因為執行環境、依賴版本與 MIT 授權責任都會影響實際採用範圍。獨立核對點 4。

一個例子：澄清模糊請求｜compass-skills 的實際邊界

README 包含一個關於購買行李箱的終端機範例。使用者一開始說「我想買一個行李箱，你能告訴我哪一個最好嗎？」 task-clarifier 把「最好」轉化為決策標準：使用情境、預算和「最好」的含義。使用者回答後，它把產品類別縮小到登機箱或托運行李，然後是材質，再是尺寸，最後產生一條確認後的需求，說明是托運行李、硬殼、28 英吋、300-600 美元預算，以及耐用性作為最高優先順序。這個範例用來展示該技能如何在需求被檢查之前避免推薦任何東西。

針對 dongshuyan/compass-skills，應把 README 的功能敘述拆成可觀察的操作：先確認 compass-skills 的啟動入口，再記下 v0.3.0 的設定值、產生的輸出和失敗訊息。素材沒有提供的測試結果不應補寫成結論。這個核對方式特別適用於 Python 專案，因為執行環境、依賴版本與 MIT 授權責任都會影響實際採用範圍。獨立核對點 5。

安全模型和本機儲存｜compass-skills 的實際邊界

安全部分說明 COMPASS 將執行階段資料保存在本機。它列出了專案不會做的事情：不上傳任務資料或使用者檔案資料，不提取瀏覽器 cookie、權杖、私鑰、憑證或工作階段。task-forest 將任務資料儲存在 workspace 下，通常是 .agent-workbench/task-forest/。session-handoff-prompt 預設唯讀，並可為可分享的交接內容對本機路徑做去識別化。user-profile-keeper 預設將檔案資料儲存在 .compass-skills/user-profiles/v1 或 COMPASS_USER_PROFILE_HOME 下。README 警告 user-profile-keeper 使用無加密的本機純文字儲存，並且刪除、覆寫、發布、遠端寫入、使用憑證和全域組態更改等高風險操作需要明確確認。

相容性、驗證和授權｜compass-skills 的實際邊界

COMPASS 被描述為一個可跨代理執行環境工作的 SKILL.md 套件。README 建議在 Claude Code 中使用 npx 安裝，在 Codex 中使用帶 -a codex 的 skills CLI，在 OpenCode、OpenClaw 或其他代理中保留 AGENTS.md 並先載入 SKILL.md。腳本使用 Python 標準程式庫元件並在本機執行。公開安裝路徑已用 skills@1.5.11 驗證，README 列出了 session-handoff-prompt 的冒煙測試和 academic-humanizer 的描述性診斷。路線圖提到從真實任務歷史建立技能、根據失敗升級技能、彙總本機代理狀態以及推薦後續任務。該儲存庫使用 MIT 授權，授權文字授予使用、複製、修改、合併、發布、散佈、再授權和出售的權利，並按「原樣」提供軟體，不附帶任何保證。授權沒有說明任何支援或維護事項。

編輯結論

compass-skills 適合需求與 README 明列功能相符、能管理 Python 執行環境並願意自行承擔 MIT 授權義務的團隊；不適合把文件中的描述當成完整服務保證的使用者。採用前應以 dongshuyan/compass-skills 的 README、v0.3.0 與實際設定入口建立隔離試跑，特別觀察文件明列的輸入、輸出、權限和失敗訊息，再決定是否進入正式流程。

官方來源

1. Official README
2. Project repository
3. Release notes