自动化与脚本
需要查询/支付 Teneo 网络 agent 或部署自有…
通过捆绑的 `~/teneo-skill/teneo` CLI 查询实时 Teneo 网络 agent、处理 x402 USDC 支付、管理房间/钱包,并部署、发布和管理自有 agent。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
需要查询/支付 Teneo 网络 age特定
解决思路
- 检查 CLI 是否存在:`test -f ~/teneo-skill/teneo && ~/teneo-skill/teneo version || echo "NOT_INSTALLED"`。
- 若 CLI 缺失,先运行 `pkill -f '/teneo-skill/daemon' 2>/dev/null || true`,再仅通过 `npx -y @teneo-protocol/cli` 安装。
- 验证安装与连通性:`~/teneo-skill/teneo health --json` 和 `~/teneo-skill/teneo version`。
- 只使用捆绑 CLI `~/teneo-skill/teneo`。
- 如果 CLI 缺失,只通过 `npx -y @teneo-protocol/cli` 安装。
- 一次只运行一个 Teneo 命令,不并行运行。
- 等待进程退出后再解析 stdout。
- 对需要解析或依赖机器可读错误的命令优先加 `--json`。
- 执行前先收集 agent 信息;用 `list-agents`、`info`、`quote`,不要猜。
- 不要发明 agent ID、命令语法、room ID 或路径;从 CLI 发现。
- 不要根据部分输出声称部署成功;用 `agent status`、`agent logs`、`agent services` 确认。
- 当前 CLI 不暴露旧的手动交易审批工作流,不要提也不要用。
- 此仓库不再提供单独的部署技能;使用本技能中的 `agent` 工作流。
- 对 swaps、bridges、trades、sends 或任何可移动用户资金的操作,执行前明确确认意图。
- 把 `wallet-export-key` 视为危险;仅在用户明确要求时运行。
- 如果已确认的 swap、bridge、trade 或 send 失败一次,不要停在泛泛提问;先诊断,安全时重试一次。
- 查看完整 CLI 面:`~/teneo-skill/teneo --help` 显示顶层命令组和常见用法;`~/teneo-skill/teneo agent --help` 显示部署和管理子命令;`~/teneo-skill/teneo --dump-commands` 返回完整机器可读命令清单。
- `COMMAND_REFERENCE` 由 manifest 生成;行为不清时以本技能内嵌 CLI 源码为准。
- 多数操作命令在 stdout 返回 JSON。
- 需要结构化错误和成功输出时用 `--json`。
- `version` 是纯文本。
- `export-login` 是纯文本 shell 输出。
- `agent logs` 是纯文本。
- `wallet-export-key` 在 stderr 打印警告,在 stdout 打印 JSON。
- 只有 `command` 子命令有 CLI `--timeout` 标志;其他长运行命令用 shell timeout。
- 对 `discover`、`list-agents`、`info`、`command`、`quote` 和 agent 部署操作至少使用 120 秒 shell timeout。
- 默认数据请求和 agent 工作流按顺序:验证安装和 health。
- 用 `list-agents --search` 找到正确 agent。
- 用 `info <agentId> --json` 收集 agent 详情。
- 如果命令付费或定价不清,执行前运行 `quote`。
- 如果命令有成本,需要在执行前告诉用户给当前 active wallet 充值。
- 只有在语法、定价和钱包上下文清楚后,才用 `command` 运行确切命令。
- 典型流程:`~/teneo-skill/teneo list-agents --search "keyword" --json`;`~/teneo-skill/teneo info <agentId> --json`;`~/teneo-skill/teneo command "<agentId>" "<exact trigger and args>" --json`。
- `command` 在省略 `--room` 时自动解析 room。
- `command` 在需要时自动添加目标 agent。
- `command` 自动处理支付。
- `quote` 可在执行前判断请求免费还是付费。
- 仅在用户想要特定支付链时使用 `--chain` 或 `--network`。
- 不要猜命令语法;始终先检查 `info <agentId>`。
- 可选价格检查:`~/teneo-skill/teneo quote "@<agentId> <request>" --json`。
- 优先用 `list-agents --search "<keyword>" --json` 做定向查找。
- 在每个不熟悉、付费或移动资金的 workflow 前运行 `info <agentId> --json`。
- 在执行任何不熟悉的 agent 命令前用 `info <agentId> --json`。
- 只有真正需要完整 manifest 时才用 `discover --json`。
- 使用内部 agent ID,不要用 display names。
- 如果用户给社交 profile name 而没有 `@handle`,先找到正确 handle;不要对不确定 handle 进行猜测性付费查询。
- 正常查询可跳过手动 room 管理,因为 `command` 自动解析 room 并自动添加 agent。
- 仅当用户明确要 room 控制或需调试 room state 时使用 room 命令。
- 列出 rooms:`~/teneo-skill/teneo rooms --json`。
- 列出 room 内 agents:`~/teneo-skill/teneo room-agents <roomId> --json`。
- 列出可加入 room 的 agents:`~/teneo-skill/teneo room-available-agents <roomId> --json`。
- 创建 room:`~/teneo-skill/teneo create-room "Task Room" --json`。
- 添加 agent 到 room:`~/teneo-skill/teneo add-agent <roomId> <agentId> --json`。
- 从 room 移除 agent:`~/teneo-skill/teneo remove-agent <roomId> <agentId> --json`。
- 删除 room:`~/teneo-skill/teneo delete-room <roomId> --json`。
- rooms 最多 5 个 agents。
- `subscribe` 和 `unsubscribe` 是 niche public-room 命令;正常 workflow 不要用。
- `update-room` 存在,但标准 workflow 不要依赖;live backend 可能返回 timeout。
- CLI 首次使用时自动生成钱包,除非设置了 `TENEO_PRIVATE_KEY`。
- 网络同时有免费命令和付费命令。
- 付费查询可用非常小的 USDC 余额开始;告诉用户少量即可开始。
- 如果 `info` 或 `quote` 显示付费命令,在需要时告诉用户在执行前给确切 active wallet 充值。
- x402 支付在支持的支付链上免 gas。
- 链上动作如 swaps、bridges、sends 仍需相关 source chain 上的 native gas。
- 例如 Base USDC 换 Ethereum USDC 仍需要 Base ETH。
- 任何钱包 setup 或检测步骤后,继续前总是告诉用户哪个钱包是 active。
- 该要求适用于自动生成钱包、检测到本地已有钱包、以及 `TENEO_PRIVATE_KEY` 提供钱包时。
- 钱包上下文建立时使用确切措辞:`Active wallet: 0x...`。
- 紧接着说:`Use this address for funding/ownership checks.`。
- 如果 `check-balance --json` 显示相关链无资金,加一条短提醒:在继续付费查询或部署前给该确切钱包在所需链充值。
- 有用钱包命令:`wallet-init --json`、`wallet-address --json`、`wallet-pubkey --json`、`wallet-balance --json`、`check-balance --json`、`export-login`。
- 推荐钱包检查流:当钱包上下文可能不存在时运行 `wallet-init --json`。
- 运行 `wallet-address --json` 并立即分享返回地址。
- 在付费查询、部署或发布流程前运行 `check-balance --json`。
- 付费或移动资金前:建立钱包上下文并分享 active wallet address。
- 成本不清时用 `info` 或 `quote`。
- 对是否有资金有疑问时运行 `check-balance --json`。
- 余额为空则停止并让用户给该确切钱包充值。
- 在 swaps、bridges、trades、sends 或任何可移动资金命令前确认意图。
- 支付或链上执行失败时立即运行 `check-balance --json`。
- 在猜测滑点、流动性或路由前,先检查 source-chain token balance 和 source-chain native gas balance。
- 如果所有余额为空,停止并让用户给钱包充值。
- 如果只有一个支付链有资金,用 `--chain <chain>` 重试。
- 如果用户已确认动作且失败看起来是 transient 或 generic,诊断后用完全相同命令重试一次;不要在这第一次重试前用模糊的“需要我...吗”停止。
- 如果钱包缺资金、native gas 明显太低,或重试需要改变金额、链、token pair 或 route assumptions,停止并告诉用户具体 blocker,不要猜。
- Swap 和 bridge 重试策略:确认的 swap 或 bridge 第一次失败不是 workflow 结束。
- 先诊断,余额看起来足够且重试不改变用户意图时做一次具体重试。
- 不要静默循环重试。
- 一次重试后报告 exact blocker 和下一步具体动作。
- 用确定性、非交互流程;不要让 LLM 围绕 `agent create` 即兴交互。
- 部署顺序:用 `agent create` 初始化 scaffold。
- 在 CLI 报告的确切路径编辑生成的代码和 metadata。
- 验证 metadata。
- 部署 agent,这会安装为本地服务。
- 想在公开时发布。
- 从已知 parent directory 运行 init 使路径可预测:`cd ~/teneo-skill` 然后 `~/teneo-skill/teneo agent create "My Agent" --id my-agent --type command --description "Full description of what the agent does." --short-description "One-line summary." --category "Developer Tools" --json`。
- 总是传 `--id`、`--description`、`--short-description` 和 `--category`。
- 优先从 `~/teneo-skill` 运行 init,使项目路径为 `~/teneo-skill/<agent-id>`。
- 如果 init 在别处运行,使用命令输出中的确切 created path;之后绝不要猜目录。
- `agent create` 是 scaffold 步骤;CLI 会确切告诉你代码和 metadata 创建在哪里。
- init 后把代码放入生成的 scaffold,而不是手工创建独立项目结构。
- 默认 `agent create` 复用 active CLI wallet,使同一 CLI 可立即看到并尝试私有部署。
- 仅当有意为该 agent 使用单独 owner wallet 时用 `--new-key`。
- 在 `agent deploy` 或 `agent publish` 前,建立钱包上下文并按钱包披露规则分享 active wallet address。
- 代码、验证、部署、发布命令:`~/teneo-skill/teneo agent validate ~/teneo-skill/my-agent/my-agent-metadata.json --json`;`~/teneo-skill/teneo agent deploy ~/teneo-skill/my-agent --json`;`~/teneo-skill/teneo agent status my-agent --json`;`~/teneo-skill/teneo agent logs my-agent --no-follow`;`~/teneo-skill/teneo agent services --json`;`~/teneo-skill/teneo agent publish my-agent --json`。
- 编辑代码、metadata 和 `.env` 时使用 `agent create` 打印的确切 scaffold 路径。
- CLI 生成的 scaffold 是 implementation 所在;不要猜另一个位置。
- `agent deploy` 构建 Go binary、免费 mint NFT identity,并安装服务。
- 把 `agent deploy` 视为本地服务的安装步骤。
- 不要把 minting 本身说成付费步骤。
- 只有在检查 `agent status` 和 `agent services` 后才说 agent 已部署。
- 如果 status 是 `stopped` 或 `offline`,不要声称成功;先读 logs。
- 只有在 deploy 成功且服务健康后才 publish。
- `agent publish` 是使 agent 公开的步骤。
- 如果部署或发布需要资金,提醒用户给确切 active wallet address 在所需链充值。
- deploy 失败时,如果 `agent status` 显示 `stopped` 或 `offline`,立即运行 `~/teneo-skill/teneo agent status <agentId> --json`、`~/teneo-skill/teneo agent logs <agentId> --no-follow`、`~/teneo-skill/teneo agent services --json`。
- 然后检查底层 service manager:Linux 用 `systemctl --user status <agentId> --no-pager` 和 `journalctl --user -u <agentId> -n 200 --no-pager`;macOS 用 `launchctl list | grep ai.teneo.agent` 和 `cat ~/.teneo-wallet/logs/<agentId>.err.log`。
- 常见原因:metadata 无效或不完整;init 后 agent 目录/路径猜错;服务启动但 binary 在启动时退出;agent ID 已被占用或 publish/deploy 状态不一致;agent `.env` 缺期望值或被手动改错。
- 远程主机上保持流程明确:`~/teneo-skill/teneo daemon stop || true`;`export TENEO_DAEMON_PORT=19888`;`~/teneo-skill/teneo daemon start --json`。
- 正常端口忙或启动不稳时使用非默认 daemon port。
- 如果 daemon 启动仍失败,不要继续猜;先检查实际错误。
- `agent not found or disconnected`:找替代 agent,或在检查 `info` 后重试。
- `room is full`:移除一个 agent 或创建新 room。
- `insufficient funds`:运行 `check-balance --json` 并给钱包充值。
- `status: timeout`:不要立即假设失败;先检查后续状态、余额、日志或交易结果。
- swap、bridge 或 send 期间 `execution revert` 或模糊链上错误:立即运行 `check-balance --json`,验证 source-chain native gas 和 token balances,如果资金看起来足够,重试一次。
- 如果 native gas 缺失或只剩 dust,明确说明,不要默认给出模糊滑点解释。
- 静默失败或无响应:先检查 `daemon status`。
- `Daemon failed to start`:停止 daemon,修改 `TENEO_DAEMON_PORT`,重试,然后检查日志。
- `Room update timeout`:除非用户明确需要,避免 `update-room`。
- 环境变量:`TENEO_PRIVATE_KEY` 使用现有钱包而非自动生成存储;`TENEO_DEFAULT_ROOM` 默认 room ID;`TENEO_DEFAULT_CHAIN` 默认支付链;`TENEO_WS_URL` 覆盖 backend WebSocket endpoint;`TENEO_DAEMON_PORT` 覆盖 daemon port;`TENEO_DAEMON_IDLE_TIMEOUT_MS` 覆盖 daemon idle shutdown timeout 毫秒。
- CLI 自动加载 `~/teneo-skill/.env`。
- 使用 39 个命令覆盖:BROWSE & QUERY NETWORK AGENTS:`health`、`discover`、`list-agents`、`info <agentId>`;SEND COMMANDS TO AGENTS:`command <agent> <cmd>`、`quote <message>`;ROOM MANAGEMENT:`rooms`、`room-agents <roomId>`、`room-available-agents <roomId>`、`create-room <name>`、`update-room <roomId>`、`delete-room <roomId>`、`add-agent <roomId> <agentId>`、`remove-agent <roomId> <agentId>`、`owned-rooms`、`shared-rooms`、`subscribe <roomId>`、`unsubscribe <roomId>`;DEPLOY & MANAGE YOUR OWN AGENTS:`agent create <name>`、`agent validate <file>`、`agent publish <agentId>`、`agent unpublish <agentId>`、`agent list`、`agent status <agentId>`、`agent logs <agentId>`、`agent deploy <directory>`、`agent undeploy <agentId>`、`agent services`;WALLET MANAGEMENT:`wallet-init`、`wallet-address`、`wallet-pubkey`、`wallet-export-key`、`wallet-balance`、`wallet-send <amount> <to> <chain>`、`check-balance`、`export-login`;DAEMON & UPDATES:`daemon <action>`、`update`、`version`。
- 典型 live agent 调用示例:`~/teneo-skill/teneo command "amazon" "product <ASIN> <domain>" --room <roomId>`;`~/teneo-skill/teneo command "gas-sniper-agent" "gas" --room <roomId>`;`~/teneo-skill/teneo command "google-maps" "business <url>" --room <roomId>`;`~/teneo-skill/teneo command "instagram" "profile <username>" --room <roomId>`;`~/teneo-skill/teneo command "tiktok" "video <url>" --room <roomId>`;`~/teneo-skill/teneo command "coinmarketcap-agent" "top <number>" --room <roomId>`;`~/teneo-skill/teneo command "layerzero" "bridge <amount> <token> <fromChain> <toChain>" --room <roomId>`;`~/teneo-skill/teneo command "linkedin-agent" "enrich_url <url>" --room <roomId>`;`~/teneo-skill/teneo command "messaribtceth" "details <coin>" --room <roomId>`。
适用边界 · 注意事项
- 不需要查询 Teneo 网络 agent、处理 Teneo 支付或部署 Teneo agent 时不适用。
- 无法安装或运行 `npx -y @teneo-protocol/cli`,或环境不允许后台 daemon/本地 service 管理时不适用。
- 不允许使用加密钱包、USDC 支付或链上资金操作,或不愿处理私钥和资金风险时不适用。