---
name: grix-egg
description: 程序主线孵化：AI 只整理参数并调用 `grix_egg`，由程序完成创建、安装、绑定、验收与状态回传。
---

# Grix Egg

`grix-egg` 采用“程序为主、AI 为辅”。
AI 不再手工接力 create/bind/accept。

## 1. AI 角色边界

你只做三件事：

1. 把用户输入整理成标准参数
2. 调用 `grix_egg`
3. 按返回 JSON 给用户汇报结果/补参

不要手工执行下面动作：

1. 远端 agent 创建
2. 本地 bind
3. gateway 操作
4. 测试群验收

## 2. 标准调用入口

优先传安装卡原文：

```json
{ "installContext": "<raw json>" }
```

如果没有安装卡，传结构化参数：

1. `route`: `create_new` | `existing` | `existing_claude`
2. `agentName`
3. `agentIdSlug` 或 `localAgentName`
4. `downloadUrl`
5. `existingCredentials`（`existing` 必填）
6. 可选：`packageHash`、`soulContent`、`soulFile`、`categoryId`、`categoryName`、`isMain`、`expectedSubstring`、`statusTarget`、`resume`、`installId`

## 3. 路线行为

1. `create_new`：程序自动完成创建、安装、绑定、验收、状态回传
2. `existing`：程序自动完成已有凭证安装与验收
3. `existing_claude`：程序返回 `unsupported_route`，由独立 Claude 安装器处理

## 4. 验收规则

程序固定验收逻辑：

1. 测试群成员必须包含：主 agent、触发用户、目标 agent
2. probe 使用 `@<target_agent_id>` mention
3. 只接受 probe 之后目标 agent 的第一条非空回复
4. `expectedSubstring` 仅是可选增强条件

## 5. 结果汇报

当 `ok=true`：

1. 汇报 `install_id`、`route`、目标 agent、验收结果
2. 如有 `acceptance.reply_content` 和 `testGroup`，一起给用户
3. 若 `interaction_status=degraded`，说明主流程成功但回传部分失败

当 `ok=false`：

1. 直接使用 `reason`、`suggestion` 解释失败
2. 只补程序明确缺失的外部输入
3. 需要续跑时使用 `resume=true` + `installId`

## 6. 禁止项

1. 禁止 `curl`/`fetch`/`axios` 直连 `/v1/agent-api`
2. 禁止手工修改 `openclaw.json`
3. 远端动作只走 typed tools：`grix_admin`、`grix_group`、`grix_query`
4. 未完成验收前不得宣称安装成功

## References

1. [references/api-contract.md](references/api-contract.md)