mcpField
A
agy-native

agy-native

github.com/boshu2Agent 工作流45058 次安装今天更新
代码仓库

关于 agy-native

agy-native 面向明确选择 AGY（Antigravity）运行时的调用方，可在限定工作区内执行指定任务包、记录运行证据并停止，不会静默切换运行时。

主要功能

  1. 01显式选择 AGY 运行时
  2. 02限定工作区与任务包
  3. 03为无头执行设置时限
  4. 04披露权限模式
  5. 05报告运行时证据

适用场景

  1. 01使用 AGY 执行指定任务包
  2. 02记录限时无头运行的证据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/boshu2/agentops --skill agy-native

安装后在 Claude Code 中输入/agy-native确认已加载。

详细介绍

AGY Native

仅当调用方明确选择该运行时，才在 AGY（Antigravity）中运行提供的数据包。将运行范围限制在提供的工作区和数据包内，返回运行时证据，然后停止。

启动前

  1. 读取当前界面。 运行 agy --help 查看标志和默认值，并运行 agy models 查看当前模型集。CLI 的变化速度快于技能文本。包装器漂移是指 根据记忆中的语法构建运行，而语法已悄然变化：看似限制了范围，实际并非如此。
  2. 缺失即停止。 如果找不到 agy，或无法读取其帮助信息， 请报告缺失情况并停止。绝不静默回退到 Codex、Claude 或 任何其他运行时；替代方案需要调用方重新选择。也没有任何机制会自动将 工作路由到 AGY。仓库审核器库将 AGY 评为常规级、降级备用审核器；此评级仅在 调用方选择使用时适用，不会触发自动路由。
  3. 设置明确的时限。 打印模式（agy -p / --print）是无头运行路径，且没有 内置时限：--print-timeout 默认为 0，会一直等待，直到本轮完成（AGY 1.2.14）。 将调用方剩余的截止时间传给 --print-timeout，并在进程外设置相同的时限。在 时限内停止的运行属于超时，不是结果。
  4. 说明权限姿态（见下文），并确认数据包声明的影响范围及调用方授权涵盖该姿态。
  5. 让作者与验证器保持分离。 验证器必须是在新会话中的新运行，绝不能使用 -c/--continue 或 --conversation <author-id>。自行审核工作的会话会失去新鲜判断， 而这正是验证器证据可用的基础。验证器保持只读，并将判断交给 Validate；它们绝不编写核心结论。

权限姿态（须说明；绝不可假定）

标志决定权限姿态。请说明所用的姿态：

  • 不带姿态标志：AGY 会针对每次工具调用提示权限。无头运行时无人可以 回答，因此提示可能会让运行停滞，直到时限到达。
  • --dangerously-skip-permissions：自动批准所有工具调用。仅当声明的影响范围和调用方授权 涵盖这一影响半径时才使用。
  • --sandbox：限制会话的终端访问权限。
  • --mode（plan、accept-edits）：更改执行模式；请在 agy --help 中确认其 当前含义。

命令

以下所有 agy 标志都出现在 AGY 1.3.1 的 agy --help 中；使用前请重新检查。 DEADLINE_EPOCH 是调用方一次性设定、并在其范围内每次运行中重复使用的绝对 Unix 时间， 因此第二次运行只能使用剩余时间，而不会获得新的时限。POSTURE 是一个 Bash 数组，包含 上文选定的姿态标志，例如 POSTURE=(--sandbox)；空数组表示 AGY 会针对每次工具调用进行询问。 PROMPT_FILE 是一个绝对路径。数据包通过路径传递，而不是内联传递：使用简短的 -p 指针加上 --add-dir，就像 scripts/lib/codex-exec.sh 所做的那样，因为大型内联提示词可能会被丢弃，但运行看起来仍像是限定了范围。

TO=$(command -v timeout || command -v gtimeout) || { echo "no timeout: not launching" >&2; exit 2; }
remaining=$(( DEADLINE_EPOCH - $(date +%s) ))
[ "$remaining" -gt 0 ] || { echo "deadline passed; not launched" >&2; exit 124; }
cd "$WORKSPACE" || exit 2
"$TO" -k 10 "$remaining" \
  agy --print-timeout "${remaining}s" --model "$MODEL" --output-format json \
  "${POSTURE[@]}" --add-dir "$(dirname "$PROMPT_FILE")" \
  -p "Read the task packet at $PROMPT_FILE and do what it describes." >"$OUT" 2>"$ERR"
rc=$?  # 124, or 137 after the 10 s grace: the outer bound stopped the run

--print-timeout 接受带单位的时长，例如 300s。将标志放在 -p 之前，以免任何标志落在提示词文本之后。AGY 的帮助信息没有说明其打印超时触发时会返回哪种状态，因此除非输出显示本轮已完成，否则在时限处结束的运行都属于超时。

返回

command:      exact argv (prompt by reference)
posture:      permission, sandbox and mode flags used
model:        requested model; observed model if AGY reported one, else unknown
conversation: id AGY reported, else unknown
bound:        --print-timeout value and the outer deadline
outcome:      exit status | timed out | not run (reason)
artifacts:    captured output and changed-file paths

AGY 插件、记忆、权限、重试和会话状态都属于运行时事实；它们绝不会成为 AgentOps 阶段、队列或完成状态。安装、插件变更和定期调度都需要单独的明确授权。

评论

支持 Markdown