Communitygithub.com

Amitro1234/keshet-claude-skills

name: company-agent-guardrails

keshet-claude-skills 是什么?

该公司代理护栏技能为AI编码代理(如Claude Code、Cowork等)定义了切实可行的安全护栏。其核心目标是让人类对危险操作保持可见控制,而非提供沙箱级安全防护。该技能通过“拒绝”、“询问”、“监控”和“指导”四个分类来管理代理的行为,例如禁止密钥泄露和破坏性系统命令,对git推送和部署等操作要求人工确认,并对所有shell执行进行监控记录。它支持所有使用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. 明确说明局限:指令文件仅引导行为;钩子/端点工具提供更强执行,但两者均非完整OS沙箱,不具备真正隔离。

规则起草工作流

  1. 询问规则应存放的位置:个人配置、项目共享配置,或两者兼有。
  2. 询问每个类别应如何处理:阻止、询问、监控或允许。
  3. 起草最小且最有用的规则集。
  4. 包含触发规则的操作示例。
  5. 包含已知局限——仍需沙箱化或端点控制的部分。
  6. 若写入文件,使用目标应用的原生位置;保持策略措辞与应用无关。

推荐的默认策略

除非公司提供更严格的政策,否则使用以下策略:

  • 拒绝: 密钥泄露、管道到shell(如 curl ... | sh)、禁用沙箱/权限、破坏性系统命令(递归删除、磁盘格式化、历史记录清除)、凭据仓库访问。
  • 询问: git推送/强制推送、部署、包安装、Schema变更、写入项目目录之外的文件、任何不在组织批准列表中的MCP工具调用。
  • 监控: 所有shell执行、项目内文件写入、外部API调用——记录并可见,但不阻止。

不应做的事

  • 未经用户明确批准,不得安装MCP服务器、钩子或持久服务
  • 不得读取、显示或传递任何 .env 文件或凭据文件到任何上下文中
  • 未经确认不得执行破坏性shell命令
  • 不得在用户未确切看到将要推送的内容时推送至git或执行部署
  • 不得访问当前项目目录之外的文件路径
  • 不得静默重试失败操作——始终暴露失败信息
  • 不得将仅含指令的护栏文件视为操作系统级强制执行
  • 未经安全审查,不得安装来自未经验证来源的第三方代理工具——优先审查源代码而非安装预构建发布产物,并通过校验和验证和试点环境引导安装

输出模板

当提出护栏集时,始终使用以下格式回复:

## 防护概要
<简要说明受保护的内容>

## 策略
- 拒绝:   <被直接阻止的操作>
- 询问:   <需要用户明确确认的操作>
- 监控:   <被记录且可见但不被阻止的操作>

## 待创建或更新的文件
- `<路径>`:<该文件的作用>

## 局限性
<这些护栏不强制执行的内容——需要额外沙箱化或端点控制的部分>

相关技能