用途:tk-wizard 用于引导必须由用户本人执行的主机会话类操作,包括账号开通与仪表盘设置、凭据或密钥的签发与放置、登录/MFA/OTP/CAPTCHA/passkey、权限与钥匙串、设备配对,以及迁移或切换过程中的人工步骤。对于调用方无法安全执行的主机配置、认证、权限或重启动作,也可作为精确的消费者交接点;代理本身可安全执行的常规代码/CLI 任务、产品决策与验收验证不在其范围内。
主要能力与用法:运行时先读取仓库与当前主机证据,建立内部状态,包括完整旅程与顺序、每个值的来源与去向、秘密/公开分类、已完成步骤、待用户执行步骤、不可逆步骤与可验证的完成信号。开场给出整体流程概览,随后只引导用户当前应做的下一步,并在观察到上一步完成后才继续,不重复确认已完成步骤,也不臆造未知的界面、按钮、URL 或命令;证据不足处仅标注为 Unverifiable。涉及界面时逐字引用既有 UI 标签(含语言、大小写、标点与空格),标题、路由、标识符或工单措辞本身不足以证明入口路径。
秘密与安全限制:绝不在对话、Markdown、日志或 eval 中回显或保存秘密;不提示用户把 OTP、密码、令牌、会话值或恢复码粘贴到对话中。需要文件传递输入时,须先证明 git ls-files -- .tigerkit/ 无跟踪路径且 git check-ignore -q -- .tigerkit/ 成功,创建 .tigerkit/secret-input/tk-wizard-<run-id>/input.json,目录模式 0700、文件模式 0600,先展示仓库相对路径与绝对路径及免密模板,不启动编辑器或聚焦类应用收集值,使用有界元数据轮询,校验后使用同一快照,并在成功、失败或异常后立即删除并确认无残留。不可逆、影响生产或无法验证的步骤需显式确认;无安全验证路径时应说明 Blocked 或 Unverifiable,而非仓促执行。结束时简述用户完成了什么及如何验证,以 Pass、Pending、Blocked、Unverifiable 或 Fail 之一作为终止状态。