Communitygithub.com

bilals2008/bilal-skills

AI 智能体技能集合,用于 Web 系统和应用开发——TypeScript、React、shadcn/ui、提交规范

bilal-skills 是什么?

该技能是一套面向 AI 智能体(如 Claude Code、Coder、Cursor 等)的 Git 泄漏预防指令集合。它能自动扫描 Git 仓库中的敏感文件(如 .env、密钥、凭据、构建产物、日志等),通过 pattern 匹配识别风险,并自动修复 .gitignore 文件来阻止未来泄漏。技能支持全平台(Windows PowerShell、Linux/macOS),并提供了清晰的步骤流程:扫描 → 检测 → 修复 → 报告 → 提交。其核心价值在于帮助开发者快速发现和修复已跟踪的敏感信息,避免机密暴露在公共仓库中,同时生成友好的用户报告。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add bilals2008/bilal-skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Git 泄漏预防

目的

防止敏感文件、密钥和构建产物被推送到 GitHub。扫描、检测并自动修复 .gitignore。

指令

第 1 步 — 扫描敏感文件

运行此命令查找不应出现在 GitHub 上的文件:

git ls-files | findstr /i ".env .env.local .env.production .env.staging node_modules dist build releases *.key *.pem *.p12 secrets"

在 PowerShell 上:

git ls-files | Select-String -Pattern "\.env|node_modules|dist|build|releases|\.key$|\.pem$|\.p12$|secrets|\.log$|\.cache$"

同时检查未跟踪的敏感文件:

git status --porcelain

第 2 步 — 检查常见敏感模式

在已跟踪文件中查找以下模式:

模式风险操作
.env / .env.*API 密钥、数据库密码从 git 中删除 + 添加到 .gitignore
node_modules/依赖项(庞大,不需要)删除 + .gitignore
dist/ / build/编译输出删除 + .gitignore
releases/二进制发布包删除 + .gitignore
*.key / *.pem私钥删除 + .gitignore
*.p12 / *.pfx证书删除 + .gitignore
.DS_StoremacOS 元数据.gitignore
Thumbs.dbWindows 元数据.gitignore
*.log日志文件.gitignore
.cache/缓存文件夹.gitignore
coverage/测试覆盖率.gitignore
.turbo/ / .next/构建缓存.gitignore
*.sql数据库转储(有时含密钥)检查内容

第 3 步 — 检查代码中的密钥

在已跟踪文件中搜索硬编码的密钥:

rg -i "(api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*['\x22]" --type-add 'code:*.{ts,tsx,js,jsx,json,yaml,yml,env,config}' -t code

查找类似这样的模式:

  • API_KEY=sk-...
  • SECRET=...
  • PASSWORD=...
  • PRIVATE_KEY-----BEGIN
  • token: "eyJ..."

第 4 步 — 自动修复 .gitignore

如果发现敏感文件,自动更新 .gitignore:

# 检查当前 .gitignore
cat .gitignore

添加缺失的条目。Web 项目标准的 .gitignore:

# 环境文件
.env
.env.local
.env.production
.env.staging
.env.development

# 依赖项
node_modules/

# 构建输出
dist/
build/
release/
releases/

# 密钥
*.key
*.pem
*.p12
*.pfx

# IDE
.vscode/settings.json
.idea/

# 操作系统
.DS_Store
Thumbs.db

# 日志
*.log
npm-debug.log*

# 缓存
.cache/
.turbo/
.next/
.nuxt/

# 覆盖率
coverage/

# 其他
*.swp
*.swo

第 5 步 — 从 Git 跟踪中删除敏感文件(如果已被跟踪)

如果敏感文件已被跟踪:

# 从跟踪中删除但保留本地
  git rm --cached .env
git rm --cached -r node_modules/
git rm --cached -r dist/
git rm --cached -r build/

# 然后添加到 .gitignore

警告: 如果密钥已被推送到 GitHub,它们已经泄露。用户应:

  1. 立即轮换所有暴露的密钥/凭证
  2. 绝不重复使用相同的密钥

第 6 步 — 向用户展示报告

清晰呈现发现结果:

🔍 安全检查报告

风险文件:
  ❌ .env — 已被跟踪(包含密钥)
  ❌ node_modules/ — 已被跟踪(应被忽略)
  ⚠️ dist/ — 已被跟踪(构建输出)

已采取措施:
  ✅ .env 已添加到 .gitignore
  ✅ node_modules/ 已添加到 .gitignore
  ✅ dist/ 已添加到 .gitignore
  ✅ .env 已从 git 跟踪中删除(本地保留)

⚠️ 如果 .env 包含真实密钥,请立即轮换它们。
   GitHub 历史记录中仍保留旧版本。

第 7 步 — 提交修复

git add .gitignore
git commit -m "chore(security): update gitignore to prevent secret leaks"

禁止操作

  • ❌ 绝不能在实际报告中显示密钥值(应掩码:sk-****...****)
  • ❌ 绝不能提交 .env 或密钥,即使是“临时”原因
  • ❌ 如果密钥已被推送,绝不能忽略警告
  • ❌ 绝不能跳过检查 git ls-files — 未跟踪文件没问题,已跟踪文件才是风险

预期输出

一份清晰的安全报告,显示:

  1. 发现的风险内容
  2. 自动修复的内容
  3. 用户需要手动完成的操作(轮换密钥)

相关技能