SuperAPI AI 工具集

gjc-sdk-author

编程与开发

查看项目

更新于 10-16 06:16

技能介绍

用途:编写受信本地脚本,经由 broker 绑定的 gjc sdk session CLI 以子进程方式操作 GJC 会话。

主要能力与契约:从本技能目录下的 templates/direct-sdk.ts 和 templates/direct-sdk.py 两个模板起步。CLI 将实时控制路由到 SessionRouter,将生命周期变更路由到 SessionLifecycleService 与 Broker。必须显式提供仓库与 session ID;以仓库为子进程工作目录运行 CLI,不得根据本地状态推断会话。禁止扫描 .gjc/state/sdk、解析 endpoint 记录、读取 endpoint 凭据或打开每会话原始 WebSocket。

用法:固定检查查询使用 gjc sdk session raw query <sessionId> --query <query> --json;固定控制使用 gjc sdk session raw control <sessionId> --op <operation> --json-input <object> --confirm --json。raw 叶子不接受 --repo,需以所选仓库作为子进程 cwd。CLI 参数以 argv 数组传递,不得经 shell 命令字符串。查询与控制操作名保持固定白名单,分发前拒绝形似密钥的输入字段。每次变更前须有紧邻的、单次使用的人工批准,使用模板带 nonce、绑定 operation/session/input 的标准输入挑战,不得用可复用布尔值替代。拒绝或取消后不得再发送请求。持久工作流控制须绑定预期 session ID。

错误与证据:显式请求 --json;成功时为 JSON,默认普通失败为 stderr 文本。即使非零退出也要解析 stdout,保留 gjc.command-error version 1 信封(含 outcome certainty、精确引用、证据可用性与继续方式),不得因 idempotency 引用 kind 含 “key” 而脱敏。畸形或非结构化响应保持通用,不得渲染原始 CLI stderr 或凭据。检查可同时报告独立查询失败与成功,不得丢弃结构化对账证据。任何失败都不授权盲目重放或自动恢复。更广的生命周期编排应放在 gjc sdk session raw global(带稳定 idempotency key)或 SDK-core 生命周期门面之后。

限制:批准是受信本地的程序性防护,并非能力隔离,Broker 与 Router 仍保留挂载权限。生成的用户脚本应放在用户工作区;仅两个规范模板属于该 clean-generated bundle。