SuperAPI AI 工具集

use-t3code-cli

编程与开发

查看项目

更新于 10-16 06:24

技能介绍

用途:通过 t3code CLI 作为受支持接口操作 T3 Code,把文件夹或 Git 仓库解析为项目、按策略创建缺失项目并发起交接线程,不直接读取 T3 凭据或构造 bearer token。

就绪检查:运行 t3code --json doctor,data.ok 为 false 视为阻塞;t3Server.ok 为 false 时应请用户启动 T3 Code。

解析项目:先检查当前工作区与匹配项目,运行 t3code --json projects resolve --cwd .。默认 workspaceMode 为 repo,会把嵌套文件夹解析到 Git 根;仅当必须把精确子目录作为独立项目时才用 --workspace-mode folder。链接的 Git worktree 会解析到主检出项目,data.workspace.mainWorktreeRoot 显示该检出;--checkout current 在同一 worktree 工作,--checkout worktree 则基于链接 worktree 当前分支新建 worktree。

发起交接线程:通过 stdin 传提示词,避免 shell 引号与命令长度问题:printf '%s' "$HANDOVER_PROMPT" | t3code --json handover --stdin(PowerShell 使用 $handoverPrompt | t3code --json handover --stdin)。--cwd 默认进程当前目录;可用 --provider、--model、--speed、--thinking-effort、--permission、--mode build|plan、--checkout current|worktree 选择线程控制。除非标志或 CLI 配置覆盖,新线程继承项目保存的完整模型选择;缺失项目使用检测到版本默认模型(0.0.28 为 gpt-5.4,0.0.29 及以后为 gpt-5.6-sol)。权限默认 full-access,应用于新线程、首轮与原子 worktree 引导;显式 --permission 或 runtimeMode 优先。默认 --checkout t3 时按项目 defaultThreadEnvMode、workspace t3.json 值、全局默认顺序解析。--project-policy existing 用于未授权创建项目,默认为 create。--dry-run --open none 可预览命令而不改状态。

结果解读:读取 data.project.id、data.thread.id、data.projectCreated、data.opened。成功桌面展示可能报告 opened.exactThread: false,线程仍在已解析项目中创建。遇到 {"ok": false} 应报告 error.code、error.message 及 error.cause;不要盲目重试写命令,每次尝试都会创建新线程 id。

兼容性:T3 0.0.28 及以后支持新 worktree 交接;创建遵循显式 newWorktreesStartFromOrigin 设置,缺失时 0.0.28 默认 false、0.0.29 及以后默认 true。WORKTREE_REQUIRES_BRANCH 表示所选文件夹不是分支上的 Git 仓库,仅在用户或调用方明确授权下改用 --checkout current。t3code --json request get <path> 仅作只读逃生通道,路径不带前导斜杠,如 api/orchestration/shell。可选前端集成示例不安装或操作 CLI 所必需。