安全基线 Skill——面向已交付产物的九大集群
Datarim 的 security-baseline skill 定义了 S1–S9:九个安全规则集群,每当 agent 交付 skill、模板、脚本或 CI 工作流时均适用。威胁模型从 AI agent 如何传播代码开始。
当 AI agent 使用某个 skill 时,它会将该 skill 的模式复制到消费项目的运行时中。已交付的 Datarim 产物中只要有一条不安全的配方——一个 curl | bash 安装模式、一个未加引号的参数展开、一个硬编码的凭据占位符——就会传播到每一个运行 Datarim 的项目。security-baseline skill 定义了防止这种情况的底线。
该 skill 源自 2026 年 4 月的一次企业安全审计,涵盖九个集群:S1 到 S9。每当任务涉及已交付产物时,它就是 reviewer 和 security agent 在规划、QA 和合规审查期间加载的文档。
S1 和 S2——Shell 与 Python
S1 适用于已交付的 skill、agent、命令、模板和文档中的每一个 shell 脚本以及每一个 bash/sh 围栏代码块。必需规则包括严格模式(set -euo pipefail)、带引号的参数展开、经过验证的位置参数、带引号的 heredoc 终止符、禁止对用户可控输入使用 eval,以及任何地方都不得出现 curl | bash。CI 门禁是对已提交的 *.sh 文件运行 shellcheck。
S2 适用于 Python。关键规则:禁止对用户或文件系统控制的输入使用带 shell=True 的 subprocess.run;凭据写入须为原子操作且权限模式为 0o600;禁止在没有 SafeLoader 的情况下使用 yaml.load;禁止使用带 verify=False 的 requests 调用。CI 门禁是 bandit -ll -ii。
S3 和 S4——凭据与供应链
S3 涵盖凭据和密钥。任何已交付产物中都不得有硬编码值。已交付模板中凭据发现的标准参考形态是环境变量路径——项目特定的位置应放在项目自己的 AGENTS.md 中,而不是框架运行时中。意外提交后的轮换策略是 24 小时:在源头轮换、清理 git 历史、强制推送、通知克隆方。
S4 涵盖供应链。GitHub Actions 必须固定到 40 个字符的提交 SHA,而不是标签或分支。每个工作流都需要一个从最小权限开始的显式 permissions: 块。每个发布 tarball 都附带 CycloneDX 或 SPDX SBOM。发布产物必须经过 cosign 签名,发布工作流必须生成 SLSA Level 2 构建来源证明。消费端的验证配方位于 release-verify skill 中。
S5——将 Markdown 视为可执行指令
AI agent 将已交付的 Markdown 视为可执行知识。S5 正是由此而来。skill 和模板中的示例必须使用占位符和明显是合成的字符串,绝不能使用真实的 OAuth 客户端 ID 或内部主机名。任何用于说明“不要做什么”的代码块——仅为使修正后的版本易于理解而展示——都必须包裹在反例围栏中:<!-- security:counter-example -->,并紧跟修正后的模式。CI 门禁在自动扫描期间会跳过这些代码块。
S6、S7、S8、S9
S6 定义仓库卫生:LICENSE、SECURITY.md、CODEOWNERS、Dependabot 配置、分支保护和标签保护。标签保护尤为重要,因为发布后重新打标签会使 SLSA 来源证明失效。
S7 是 CI 验证门禁——阻止合并的必需作业集合:shellcheck、bandit、semgrep、gitleaks、trufflehog、actionlint、zizmor、osv-scanner、bats,以及 markdown 策略正则扫描。S8 将每个 S1–S7 集群映射到 OWASP ASVS v5、SOC 2、ISO 27001:2022 和 CIS Controls v8 中的控制项——仅供参考,不构成认证。S9 涵盖漂移和事件响应:未经架构师批准不得放宽任何规则,每个新发现都必须在七天内产生一个回归测试或在抑制注册表中产生一条已接受风险条目。
阅读什么是 Datarim了解更广泛的背景,或查看release-verify skill了解 S4 消费端验证配方。