用途:在 AI 智能体对本地仓库进行编辑前,先检查仓库风险,生成简洁的 Green、Yellow 或 Red 风险回执,帮助决定是否继续编辑。
主要能力:仅基于本地文件分析,关注破坏性 shell 模式、凭据写入自动化、智能体权限面、未提交改动以及不可用的 git 状态。可与插件中的 /agent-preflight 命令配合使用;优先使用受信任 Claude 安装根目录下的轻量扫描器,再解释决策与下一步安全操作。
使用方式:确认目标仓库路径(默认当前工作区);仅用 Read 读取解释工作区的本地文档或配置,不复制私有源码;运行 /agent-preflight 或从受信任安装根目录调用捆绑扫描器;若扫描器不可用,则手动套用相同决策规则。将工作区分类为 Green、Yellow 或 Red,并在编辑前报告决策、证据与下一步安全操作。Yellow 时先请求检查点或缩小范围;Red 时停止并请求人工审查。输出为可粘贴到工作日志或 PR 备注的 Markdown 回执,包含 Decision、Repository、Git state、Risk buckets、Evidence、Next safe action。
适用场景:准备让智能体修改仓库前、例行编辑前、存在智能体钩子或宽泛工具权限时、发现破坏性自动化时。
限制:需要本地仓库路径、Python 3(用于捆绑扫描器)、Git(当工作区为 git 仓库时)及本地读取权限。使用期间不得将源码、密钥、令牌、私有仓库内容、支付凭据或环境变量发送到外部服务。若扫描器无法从受信任安装根目录找到,需说明自动扫描未运行并改用手动规则;git 状态不可用时归类为 Yellow;文件无法解码时用容错 UTF-8 扫描可读前缀并注明证据可能不完整;若智能体可控路径中出现破坏性或凭据写入标记,归类为 Red 并停止;工作区过大时优先检查高信号路径,如 .claude/、.cursor/、.github/、shell 脚本、JSON/YAML/TOML 配置、包清单和环境文件。
资源:命令 plugins/security/agent-safety-preflight/commands/agent-preflight.md;扫描器 plugins/security/agent-safety-preflight/scripts/agent_preflight_lite.py;决策规则参考 references/decision-rules.md。