代理
JustHold 以 Cursor agents 打造:載入 skills 與 規則,而不是在對話裡反覆解釋所有慣例。此頁說明這個設計。產品原始碼為私有;Skills 目錄 則公開 playbook,方便他人重用。
Skills 與規則
| 類型 | 位置 | 角色 |
|---|---|---|
| Skills | .agents/skills/ | 有觸發條件時載入的任務手冊(堆疊、UI、Supabase、測試、commit) |
| 規則 | .cursor/rules/ | 一律生效的約束(例如 commit 敘事風格) |
工作有明確觸發時優先用 skill(「加 API 路由」、「寫 commit」)。即使沒人提起也該生效的約束,用規則。
我們如何與代理協作
- 從產品意圖出發,而不是把整個 repo 塞進提示。
- 讓對應的 skill 提供堆疊預設、檔案位置與不要做的清單。
- 對話聚焦當下步驟;耐久慣例由 skills 負責。
- Commit 遵循步驟敘事規則:多個小 commit,每個在
git log都讀得懂。
這裡公開什麼
- Skills 目錄 — JustHold 自有 skills 地圖,各連結到完整即時
SKILL.md - Agent skills — 開啟任一 skill 頁即可閱讀與複製 playbook
- UI 模式 — 共用的產品篩選樣式
- 測試 — 覆蓋率為何這樣界定
Skill 頁面直接從 .agents/skills/<id>/SKILL.md 載入,文件與 agents 實際使用的內容保持同步。
應用私有,playbook 公開
JustHold 應用程式原始碼並未開源。公開 agent skills 是為了重用,以及透明說明我們如何用 Cursor 做工程。