2026年8月23日

安全 Skill——内置于工作流中的加固配方

Datarim 的 security skill 如何将认证规则、输入校验、依赖审计和事件处置配方直接嵌入智能体工作流,而不是留待合并后审查。

在实现之后才到达的安全建议代价高昂。在提交历史中发现暴露的密钥,或在生产环境中发现存在漏洞的依赖,其成本远高于在计划阶段就将其捕获。security skill 的存在,就是为了让安全推理留在工作流之内,而非之外。

该 skill 涵盖四个方面:认证与授权、数据保护、依赖安全,以及一组针对跨项目反复出现的事件处置的操作配方。每个方面都带有具体规则,而非笼统原则。例如,关于缓存密钥的规则明确规定:任何持有原始 bearer 凭据的热存储缓存——即使具有有界 TTL 和网络隔离绑定——都必须记录在项目的已接受风险登记册中,因为运维人员对缓存的访问会绕过主密钥存储的审计追踪。

认证与输入校验

基本规则很直接:绝不硬编码密钥,在服务端校验所有输入,并对 API 密钥应用最小权限原则。数据保护又增加了三条:对用户输入进行 XSS 和 SQL 注入净化,对静态和传输中的敏感数据加密,并且绝不记录个人可识别信息。

依赖审计被刻意设计为技术栈中立。该 skill 指示智能体运行「包管理器原生的审计命令,并采用声明的严重性阈值」——具体调用方式属于项目自身的 AGENTS.md,而非共享框架文件。这样可以避免框架编码 npm 专用或 cargo 专用命令,从而在其他生态系统中失效。

事件处置配方

三个配方涵盖了在缺乏事先准备时容易引发调试会话的情形。git 历史清理配方描述了 git filter-repo 的强制双标志调用——一个标志用于 blob 内容,一个用于提交消息——因为省略第二个标志会泄露提交消息中描述脱敏操作的任何模式。该配方还规定了可接受的备份渠道(本地镜像克隆或外部对象存储),并解释了为什么在强制推送重写之后,同一仓库中的标签不是有效备份。

Tailscale 与 VPN 共存配方是面向 macOS 的五步检查清单。最常见的陷阱是在商业 VPN 之后启动 Tailscale:VPN 会占用第一个可用的隧道接口,而 Tailscale 会静默地无法建立网状连接。该配方还涵盖了 --accept-dns=false 标志,该标志可防止两个守护进程同时覆盖系统解析器并产生间歇性 NXDOMAIN 失败。

侦察与入侵的启发式判断针对的是另一种混淆:对可疑文件名返回 200 响应并不能证明已被入侵。该 skill 列出了四个指标,用于区分扫描器噪声与实际利用——异常的 base64 载荷、与配置时间不一致的修改日期、PHP worker 向未知 IP 的出站连接,以及意外的 cron 条目或 SSH 密钥。

跨技术栈路径翻转威胁模型

有一个配方因其适用范围值得注意。当任务更改 HTTP 请求的根——翻转文档根、容器卷挂载或符号链接目标——该 skill 要求审计所有相对于该根解析路径的消费者,而不仅仅是执行翻转的配置。以路径为键的运行时缓存会将不同 inode 上两个字节完全相同的文件视为不同来源,而一个从两个 inode 加载了同一个类的长时间运行 worker 会在请求时因重复声明错误而崩溃。缓解措施是让两个根在翻转期间共享同一 inode 树,然后将规范化重定位规划为后续步骤。

适用位置

security skill 是 security-baseline skill 的配套,后者持有规范的 S1–S9 规则参考。同时加载两者可覆盖安全规划;单独加载 security 则覆盖实时事件调查。该 skill 还附带两个可复用的计划模板:一个用于依赖 CVE 和框架版本升级任务,另一个用于实时服务配置翻转的原子切换与自动回滚。

阅读Datarim 是什么了解更广泛的背景,或探索自验证 skill,了解安全发现如何在验证层中结构化。