公司代理护栏
目的
为Keshet内部的AI编码代理定义并实施切实可行的安全护栏——对危险操作进行可见且需人工确认的控制,而非沙箱级安全。适用于Claude Code、Cowork以及所有使用Claude的流水线和自动化工具中的代理。默认策略类别及每款应用的文件放置路径位于 reference.md 中。
触发条件
始终对任何AI代理会话有效。在以下情况下应明确激活:新会话在Keshet项目上启动时、代理即将运行shell/git/MCP调用时、用户授予广泛的自主权(如“直接处理”)时、设计或审查流水线时、或者某个操作将接触项目目录外部的密钥或文件时。
基本原则
- 识别操作面:shell、文件读写、git、MCP调用、包安装、钩子、技能、密钥。
- 将每个控制项分类为
拒绝、询问、监控或指导。 - 优先使用小而明确的规则,而非宽泛模糊的规则。
- 保持开发人员生产力——对模糊操作进行询问,仅拒绝明确不安全的操作。
- 明确说明局限:指令文件仅引导行为;钩子/端点工具提供更强执行,但两者均非完整OS沙箱,不具备真正隔离。
规则起草工作流
- 询问规则应存放的位置:个人配置、项目共享配置,或两者兼有。
- 询问每个类别应如何处理:阻止、询问、监控或允许。
- 起草最小且最有用的规则集。
- 包含触发规则的操作示例。
- 包含已知局限——仍需沙箱化或端点控制的部分。
- 若写入文件,使用目标应用的原生位置;保持策略措辞与应用无关。
推荐的默认策略
除非公司提供更严格的政策,否则使用以下策略:
- 拒绝: 密钥泄露、管道到shell(如
curl ... | sh)、禁用沙箱/权限、破坏性系统命令(递归删除、磁盘格式化、历史记录清除)、凭据仓库访问。 - 询问: git推送/强制推送、部署、包安装、Schema变更、写入项目目录之外的文件、任何不在组织批准列表中的MCP工具调用。
- 监控: 所有shell执行、项目内文件写入、外部API调用——记录并可见,但不阻止。
不应做的事
- 未经用户明确批准,不得安装MCP服务器、钩子或持久服务
- 不得读取、显示或传递任何
.env文件或凭据文件到任何上下文中 - 未经确认不得执行破坏性shell命令
- 不得在用户未确切看到将要推送的内容时推送至git或执行部署
- 不得访问当前项目目录之外的文件路径
- 不得静默重试失败操作——始终暴露失败信息
- 不得将仅含指令的护栏文件视为操作系统级强制执行
- 未经安全审查,不得安装来自未经验证来源的第三方代理工具——优先审查源代码而非安装预构建发布产物,并通过校验和验证和试点环境引导安装
输出模板
当提出护栏集时,始终使用以下格式回复:
## 防护概要
<简要说明受保护的内容>
## 策略
- 拒绝: <被直接阻止的操作>
- 询问: <需要用户明确确认的操作>
- 监控: <被记录且可见但不被阻止的操作>
## 待创建或更新的文件
- `<路径>`:<该文件的作用>
## 局限性
<这些护栏不强制执行的内容——需要额外沙箱化或端点控制的部分>