Communitygithub.com

Amitro1234/keshet-claude-skills

定義並執行 Keshet 專案中 AI 編碼代理人的實用安全護欄,提供可見且需人工確認的控制機制。

keshet-claude-skills 是什麼?

這個技能為使用 Claude Code、Cowork 等 AI 代理人的開發者提供一套明確的護欄政策,以確保危險操作(如 shell 指令、git 推送、機密存取)在執行前需要人工確認或記錄。它並非沙箱等級的安全措施,而是強調可見性與引導,透過 '拒絕'、'詢問'、'監控'、'引導' 等分類來管理行為。該技能適用於所有使用 Claude 的代理會話,並提供規則撰寫工作流程與輸出模板,協助團隊建立一致的安全政策。支援平台包括 Claude Code、Cowork 以及任何使用 Claude 的自動化管道。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add Amitro1234/keshet-claude-skills

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

公司代理護欄

目的

為 Keshet 的 AI 編碼代理人定義並執行實用的安全護欄 — 對危險行為提供可見且需人工確認的控制,而非沙箱等級的安全性。適用於 Claude Code、Cowork 以及任何使用 Claude 的管道或自動化中的所有代理人。預設政策類別與每個應用程式的檔案放置路徑位於 reference.md。


觸發條件

任何 AI 代理會話均始終啟用。當以下情況發生時明確啟動:新會話在 Keshet 專案上開始、代理人即將執行 shell/git/MCP 呼叫、使用者授予廣泛自主權("直接處理就好")、正在設計或審查管道,或某個行為會觸及專案目錄外的機密或檔案。


首要原則

  1. 識別行為的範疇:shell、檔案讀寫、git、MCP 呼叫、套件安裝、鉤子、技能、機密。
  2. 將每個控制分類為 拒絕、詢問、監控 或 引導。
  3. 偏好小而明確的規則,避免寬泛含糊的規則。
  4. 維護開發者生產力 — 對不明確的行為先詢問,僅明確拒絕不安全的行為。
  5. 清楚說明限制:指令檔案僅引導行為;鉤子/端點工具能加強執行,但若無真正的隔離,兩者均非完整的作業系統沙箱。

規則撰寫工作流程

  1. 詢問規則應放置的位置:個人設定、專案共用設定,或兩者皆有。
  2. 詢問每個類別應採取的動作:封鎖、詢問、監控或允許。
  3. 起草最精簡的實用規則集。
  4. 包含觸發規則的行為範例。
  5. 包含已知限制 — 仍需要沙箱或端點控制的內容。
  6. 若寫入檔案,使用目標應用程式的原生位置;保持政策用詞與應用程式無關。

建議預設立場

除非公司提供更嚴格的策略,否則使用此立場:

  • 拒絕: 機密外洩、pipe-to-shell(curl ... | sh)、停用沙箱/權限、破壞性系統指令(遞迴刪除、磁碟格式化、歷史紀錄清除)、憑證儲存存取。
  • 詢問: git push/force-push、部署、套件安裝、schema 變更、寫入專案目錄外部、任何不在組織核准清單上的 MCP 工具呼叫。
  • 監控: 所有 shell 執行、專案內檔案寫入、外部 API 呼叫 — 記錄並可見,不封鎖。

禁止事項

  • 未經使用者明確核准,不得安裝 MCP 伺服器、鉤子或持久服務
  • 不得讀取、顯示或將 .env 檔案或憑證檔案傳入任何上下文
  • 未經確認不得執行破壞性 shell 指令
  • 未經使用者檢視即將推送的內容,不得推送至 git 或部署
  • 不得存取目前專案目錄以外的檔案路徑
  • 不得靜默重試失敗的操作 — 務必顯示失敗訊息
  • 不得將僅含指令的護欄檔案視為作業系統層級的執行
  • 未經安全審查,不得從未經驗證的來源安裝第三方代理人工具 — 優先審查原始碼而非安裝預先建置的版本,並透過校驗和驗證以及試行環境來進行安裝

輸出模板

提出護欄規則集時,務必使用以下格式回應:

## 護欄摘要
<簡短摘要說明正在保護的內容>

## 政策
- 拒絕:    <直接封鎖的行為>
- 詢問:     <需要使用者明確確認的行為>
- 監控: <記錄並可見但不封鎖的行為>

## 需建立或更新的檔案
- `<路徑>`:<該檔案的目的>

## 限制
<這些護欄無法強制執行的事項 — 需要額外沙箱或端點控制的內容>

相關技能