如何让AI Agent安全执行高风险操作portal-ai-plugins的actions五步dry-run防护机制完全指南【免费下载链接】portal-ai-plugins项目地址: https://gitcode.com/gh_mirrors/po/portal-ai-plugins你是否担心AI Agent在自由发挥时误删数据、误改线上配置portal-ai-plugins是一个为 Claude Code、Codex、Cursor 等 AI 编码助手提供 Spotify Portal 工作流的插件其中actions技能内置了五步 dry-run 防护机制AI 在真正执行任何高风险操作前必须先检查帮助、预览输入、向你展示变更、等你明确授权破坏性操作还需额外的--yes确认。本文将用通俗的方式带你完整理解这套安全设计让 AI 干活既高效又不敢乱来。为什么 AI Agent 需要先预览再动手想象你请一位新手助手操作生产系统你敢让他不确认就直接敲下删除命令吗AI Agent 面临的处境类似它能理解你的自然语言需求也能自己拼出命令行但它无法真正感受操作的后果。一个幻觉、一个参数写错就可能导致不可逆的变更。️ 因此安全的关键不是禁止 AI 做事而是给它一套强制流程每一步都有据可查、每一步都需要人确认。这就是 portal-ai-plugins 中 skills/actions/SKILL.md 所定义的防护机制。先认识 portal-ai-plugins 插件包这个插件仓库围绕 README.md 中定义的六条工作流组织工作流用途是否改变系统状态setup配置 Portal CLI 认证是仅本地认证doctor只读体检检查就绪状态否search自然语言搜索软件目录与文档否service生成服务简报否actions发现、预览并安全调用 Portal 操作是重点防护feedback向 Portal 团队提交反馈是需显式确认可以看到仓库在 AGENTS.md 中明确规定了两条设计红线doctor必须保持只读、文档中必须保留 JSON 输出与 dry-run 防护措施。也就是说安全不是事后补救而是从插件层面写进规范的架构约束。五步 dry-run 防护机制详解 当 Agent 需要执行一个**会修改数据的操作mutation**时必须走完以下五步一步都不能跳第一步检查命令帮助而不是凭记忆拼参数Agent 在调用任何操作前会先查看该操作自动生成的帮助信息actions action-id --help。这一步的价值在于参数以官方定义为准杜绝 AI 凭印象编造不存在的标志位。第二步用--dry-run --json精确预览输入这是整套机制的心脏。Agent 会把真实要提交的参数打包后加上--dry-run --json运行npx spotify/portal-cli actions action-id --input json --dry-run --json--dry-run让操作只模拟、不落地--json则让输出结构化方便 Agent 准确读取到底会发生什么。相当于先打印一张施工图纸而不是直接动锤子。第三步把将发生的变更展示给用户Agent 不能只给自己看预览结果——它必须把即将变更的内容用人话讲清楚改什么、影响什么、依据是什么。这一步解决的是信息不对称预览结果只有用户看懂了授权才是有意义的授权。第四步仅在用户明确授权后才执行 没有你的同意操作停在纸面。Agent 被要求等待明确授权而不是把没反对当成默认同意。第五步破坏性操作追加--yes双重确认如果该操作被标记为破坏性destructive即便你已经授权Agent 也只有在再次确认后才追加--yes标志执行。--yes在这里扮演的是最后一道闸它把破坏性操作与普通操作在命令层面区隔开日志与审计时一眼可见哪些是高危动作。⚠️ 一个容易踩的坑dry-run 成功 ≠ 执行成功skills/actions/SKILL.md 的最后一句值得划重点Never infer successful execution from a dry run.绝不能从 dry-run 推断执行成功。模拟通过只说明参数格式没问题、路径可达不代表正式执行不会遇到权限、配额等运行时问题。新手最容易犯的错误就是看到 dry-run 输出正常便向用户汇报已经完成了。正确的做法是预览归预览执行结果必须以真实执行后的输出为准。配套安全设计只读体检与最小凭证原则五步防护并非孤立存在它和另外两条安全规范互相咬合1.doctor只读体检skills/doctor/SKILL.md 定义了一套四步健康检查宿主插件是否就绪、CLI 命令面是否完整、认证实例是否明确、能否只读列举可用操作。整个过程禁止安装、禁止登录、禁止调用任何变更类操作且任何一项被阻塞时不得虚报整体就绪。这是你在动手前的安检门。2. 凭证最小化原则skills/setup/SKILL.md 明确规定永远不要让用户把令牌、授权码粘贴到聊天窗口登录走浏览器流程多实例时不许替用户猜默认实例必须询问。安全机制的边界画得非常清晰AI 可以预览、可以建议、可以等待唯独不可以替人拍板。如何快速在自己的环境里启用在你的 AI 编码助手插件市场中添加 portal-ai-plugins 仓库安装portal插件开启新会话运行/portal:setup按提示完成认证与实例选择遇到任何操作类需求时Agent 会自然走检查帮助 → dry-run 预览 → 展示变更 → 等待授权的流程——你只需要关注最后一步看清变更再决定同不同意。完整工作流说明见 skills/actions/SKILL.md 与仓库根目录的 README.md。小结防护步骤解决的核心风险① 检查命令帮助参数靠猜、标志位编造②--dry-run --json预览盲操作、变更不可预知③ 向用户展示变更信息不对称④ 用户授权后执行AI 越权决策⑤ 破坏性操作加--yes高危操作缺最后防线 portal-ai-plugins 的 actions 技能给我们的启示是驯服 AI Agent 的手靠的不是禁令而是一套可审计、可中断、可追溯的标准流程。五步走完高风险操作从听天由命变成了步步留痕。【免费下载链接】portal-ai-plugins项目地址: https://gitcode.com/gh_mirrors/po/portal-ai-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考