SuperAPI AI 工具集

mutation-gate

部署与运维

查看项目

更新于 10-16 02:27

技能介绍

用途:为 RHDH 技能提供“外部写入闸门”。外部写入指用户关闭会话后无法撤销的操作,如推送提交、打开 PR、Jira 状态流转、发布消息、修改他人仓库文件。读取(抓取、分类、分析、报告)不构成写入,不授权任何变更。

主要能力与使用方式:

  1. 声明操作。按执行顺序列出每一项,并给出:Target(准确目标,如 owner/repo#412、RHIDP-1234、分支名、频道)、Command(将实际运行的完整命令或请求,不得转述)、Preview(将落入的正文、标签、字段值或 diff)、Precondition(必须先成立的条件,执行前立即检查,不成立则停止整批)、On failure(该项失败后后续操作如何处理)、Recovery(已发生操作如何撤销或止损)。以表格形式呈现在对话中,在用户所在处批准。
  2. 获取批准。用户批准的是被展示的那组操作;先前意图不授权未展示确切目标与载荷的操作。计划变更(目标不同、增加操作、正文被改)即新计划,需重新批准。
  3. 执行并逐项报告。按计划顺序报告每项为成功、失败或跳过;因前项失败而未运行的操作报为跳过,不得遗漏;失败的写入必须报告,不得悄悄改形重试。

凭据绝不进入预览:预览显示将运行的命令,可能携带粘贴、环境插值或工具返回的令牌。展示前扫描: uv run scripts/scan_credentials.py <plan.json> --json uv run scripts/scan_credentials.py --text "<a single command or body>" 发现凭据形态字段(authorization 头、PEM 私钥、ghp_、glpat-、xox、sk-、AKIA 令牌或任意深度的疑似密钥字段)时以非零退出并指出位置,只报告字段,不报告密钥。计划中出现凭据说明命令构造有误,应修正构造,让认证工具在运行时提供密钥。

执行者与完成条件:拥有目标的技能负责执行,需要 Jira 写入时调用 /rhdh-jira-update,需要 forge 写入则自行构建并运行命令;/rhdh-forge 只构建载荷而不执行。计划过大(多仓库升级、涉及大量文件的目录变更)时,写入操作系统临时目录中的文件并打印绝对路径,遵循 /handoff 约定,不写入用户检出目录。完成条件:用户批准的所有操作均有结果、结果按计划顺序排列、每项都指明其目标;报告中缺少某项或未指明所改目标,则闸门未闭合。

限制:恢复必须写明,不能以沉默代替;确实无法撤销的(已发消息、已触发流水线、已发布包)须明确说明“无法撤销”。资料未提供具体平台适配范围、收费或性能数据。