dongshuyan/compass-skills

What it solves

COMPASS Skills 解決了長時間運行的 AI 代理工作流程中狀態與情境遺失的問題。它透過在本地管理使用者偏好、專案進度與任務相依性，避免必須重播整段對話紀錄，確保代理在不同會話間仍與使用者目標保持一致。

How it works

此專案提供一組可安裝至 AI 程式編寫代理（如 Claude Code 或 Codex）的 SKILL.md 套件。這些技能使用 Markdown 指示與本地 Python 腳本來實作特定工作流程：

• State Management：維護本地使用者個人檔案以記錄溝通偏好，並在倉庫內部建立任務圖（DAG）以追蹤目標與子任務。
• Alignment：澄清閘門會在執行前針對模糊或高風險任務提出聚焦問題，將其縮小範圍。
• Continuity：將當前對話狀態壓縮成可直接貼上的提示，供新 AI 會話使用。
• Meta-Programming：提供工具將成功的執行歷史轉換為可重複使用的新技能，或根據實際證據升級既有技能。

Who it’s for

適用於使用 AI 程式編寫代理、管理複雜且長期專案的開發者，需要一套結構化方式來維持情境、追蹤進度，並確保代理不偏離原始目標。

Highlights

• Local-First Privacy：所有任務與個人檔案資料皆儲存在本地，絕不上傳至外部伺服器。
• Task Forest：可視化的任務圖，跨越對話邊界仍能保存。
• Session Handoff：專門的提示產生器，實現 AI 對話之間的無縫切換。
• Skill Engineering：從觀察到的代理執行歷史直接構建與精煉技能的工具。