用途:该技能借助 GitHub MCP Server 的 run_secret_scanning 工具,检测内容、文件或 git 改动中的机密信息,如访问令牌、API 密钥、密码、私钥、OAuth 客户端密钥、云凭据等。仅在用户明确要求扫描内容或检查机密时使用,不应在未提示的情况下自动运行。
主要能力:可扫描用户提供的代码片段或文本、仓库中的指定文件,以及提交前的暂存改动。扫描会结合上下文(如 password、token、secret、private_key、authorization 等命名)与高熵字符串判断风险,返回潜在机密的位置和置信度提示。工具只需提供内容,不需要推送权限或特殊 GitHub 权限。
使用方式:需启用 GitHub MCP Server 的 secret_protection 工具集,并在 MCP 设置中配置 github 服务器(http 类型,url 为 https://api.githubcopilot.com/mcp/;Cursor 使用 servers 作为顶层键)。扫描时需提供仓库 owner 和仓库名,若用户未提供应先询问。扫描内容时把文本作为单元素数组传入 run_secret_scanning;扫描文件先用 Read 工具读取内容再传入;扫描暂存改动先用 git diff --cached 获取内容再传入。
适用场景:检查配置片段或代码粘贴、检查仓库中特定文件、提交前检查暂存改动。默认避免扫描 node_modules、构建产物等生成或第三方内容;.gitignore 中的文件(如 .env)仍可能含机密,需用户同意后才跳过或纳入。
限制:扫描在 GitHub 服务端进行,内容会发送至 GitHub 机密检测基础设施,结果返回后不保留内容。发现机密后,硬编码值应移至环境变量或 .env;若已提交,可能需要轮换凭据,这超出本技能范围。占位符、测试桩和文档示例值可能产生误报,不确定的发现应按敏感处理。