用途:防止代理读取仓库中的真实凭据,并防止密钥被写入 .squad/ 文件后由 Scribe 自动提交到 git 远程历史。
主要能力:
- 禁止读取 .env、.env.local、.env.production、.env.development、.env.staging、.env.test 及任何 .env.* 文件,除非明确允许;允许读取 .env.example、.env.sample、.env.template 等占位模板。
- 禁止向 .squad/ 文件写入 API Key、密码、连接字符串、JWT、私钥、AWS 凭据、邮箱地址等模式内容。
- 提供替代写法:占位符如 DATABASE_URL=<set in .env>、脱敏引用、架构说明、schema 文档。
- Scribe 提交前校验:暂存后、git commit 前扫描暂存内容,命中密钥模式则停止提交,执行 git reset HEAD <file>,报告并退出错误;无命中才正常提交。
- 已提交密钥的补救流程:立即停止新提交,提示用户撤销/轮换凭据,用 git filter-repo 或 BFG 清理历史并强制推送,等待用户确认后再继续。
使用方式:需要配置信息时直接询问用户,或读取 .env.example 与文档;Scribe 校验可用 PowerShell Select-String 或 git diff --cached 扫描暂存内容。
适用场景:多代理协作、Scribe 自动提交 .squad/ 决策与日志的仓库。
限制:资料未提供具体安装命令、平台支持范围与收费信息;密钥清理需专用工具,不应自行修复。