SuperAPI AI 工具集

zcode-delegate

编程与开发

查看项目

更新于 10-16 06:13

技能介绍

用途:当用户明确要求把某项边界清晰的编码任务委托给外部实现方 Z.AI ZCode CLI,并由自己复核其改动时使用。任务过小、未安装 ZCode 或未配置模型提供方时不应委托。

主要能力:编排方撰写任务简报,交给 ZCode 执行,再自行复核差异并提交。附带 relay.mjs 作为运行辅助脚本,结果写入临时目录,仓库保持干净;relay 不提交代码,只返回结构化 result.json,记录 CLI 版本与解析方式。也可用 --read-only 获取带写入检测的对抗性复核意见。

使用方式:先确认已安装 ZCode CLI(桌面应用内置,不在 PATH 与 npm 中;可用 --zcode-path 或 ZCODE_CLI 指定,Linux AppImage 必须指定),并在 ~/.zcode/cli/config.json 配置 provider 块,密钥可放在该文件或通过 ZAI_API_KEY、ZCODE_API_KEY、ANTHROPIC_API_KEY 环境变量提供(推荐环境变量)。运行示例:node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo;可加 --read-only、--session <sess_...>、--resume-last、--disallowed-tools、--timeout 等选项。需要 Node 18+ 与 git。

限制:仅 yolo 与 plan 两种 mode 可用于无头运行,build 与 edit 被拒绝;无 --allowed-tools,只有真正生效的 --disallowed-tools 拒绝清单;plan 模式的只读不构成保证,需确认 touchedFiles 为空;relay 从不提交,由编排方验证门禁后提交。Windows 下拒绝 .cmd/.bat,需用 --zcode-path 指定 .cjs/.mjs/.js 或原生可执行文件。已认证的 ZCode CLI 不随附。