公司代理護欄
目的
為 Keshet 的 AI 編碼代理人定義並執行實用的安全護欄 — 對危險行為提供可見且需人工確認的控制,而非沙箱等級的安全性。適用於 Claude Code、Cowork 以及任何使用 Claude 的管道或自動化中的所有代理人。預設政策類別與每個應用程式的檔案放置路徑位於 reference.md。
觸發條件
任何 AI 代理會話均始終啟用。當以下情況發生時明確啟動:新會話在 Keshet 專案上開始、代理人即將執行 shell/git/MCP 呼叫、使用者授予廣泛自主權("直接處理就好")、正在設計或審查管道,或某個行為會觸及專案目錄外的機密或檔案。
首要原則
- 識別行為的範疇:shell、檔案讀寫、git、MCP 呼叫、套件安裝、鉤子、技能、機密。
- 將每個控制分類為
拒絕、詢問、監控或引導。 - 偏好小而明確的規則,避免寬泛含糊的規則。
- 維護開發者生產力 — 對不明確的行為先詢問,僅明確拒絕不安全的行為。
- 清楚說明限制:指令檔案僅引導行為;鉤子/端點工具能加強執行,但若無真正的隔離,兩者均非完整的作業系統沙箱。
規則撰寫工作流程
- 詢問規則應放置的位置:個人設定、專案共用設定,或兩者皆有。
- 詢問每個類別應採取的動作:封鎖、詢問、監控或允許。
- 起草最精簡的實用規則集。
- 包含觸發規則的行為範例。
- 包含已知限制 — 仍需要沙箱或端點控制的內容。
- 若寫入檔案,使用目標應用程式的原生位置;保持政策用詞與應用程式無關。
建議預設立場
除非公司提供更嚴格的策略,否則使用此立場:
- 拒絕: 機密外洩、pipe-to-shell(
curl ... | sh)、停用沙箱/權限、破壞性系統指令(遞迴刪除、磁碟格式化、歷史紀錄清除)、憑證儲存存取。 - 詢問: git push/force-push、部署、套件安裝、schema 變更、寫入專案目錄外部、任何不在組織核准清單上的 MCP 工具呼叫。
- 監控: 所有 shell 執行、專案內檔案寫入、外部 API 呼叫 — 記錄並可見,不封鎖。
禁止事項
- 未經使用者明確核准,不得安裝 MCP 伺服器、鉤子或持久服務
- 不得讀取、顯示或將
.env檔案或憑證檔案傳入任何上下文 - 未經確認不得執行破壞性 shell 指令
- 未經使用者檢視即將推送的內容,不得推送至 git 或部署
- 不得存取目前專案目錄以外的檔案路徑
- 不得靜默重試失敗的操作 — 務必顯示失敗訊息
- 不得將僅含指令的護欄檔案視為作業系統層級的執行
- 未經安全審查,不得從未經驗證的來源安裝第三方代理人工具 — 優先審查原始碼而非安裝預先建置的版本,並透過校驗和驗證以及試行環境來進行安裝
輸出模板
提出護欄規則集時,務必使用以下格式回應:
## 護欄摘要
<簡短摘要說明正在保護的內容>
## 政策
- 拒絕: <直接封鎖的行為>
- 詢問: <需要使用者明確確認的行為>
- 監控: <記錄並可見但不封鎖的行為>
## 需建立或更新的檔案
- `<路徑>`:<該檔案的目的>
## 限制
<這些護欄無法強制執行的事項 — 需要額外沙箱或端點控制的內容>