用途:Debug 是 fw-ai/cookbook 中的排障技能,用于处理 Fireworks 训练与部署问题,包括任务卡住或失败、错误信息、质量不佳、检查点与恢复(resume)问题、LoRA 适配器以及服务(serving)问题。默认只读,不创建任务、不上传数据、不产生花费,除非明确移交到 configure 并给出新的已批准计划。
主要能力:按信号分流,新训练或已批准的 retry 走 configure,方法或数据不明确走 research,失败、停滞、质量差、恢复或服务问题留在 debug。排障时读取 references/triage-paths.md,先问一个类别问题(任务状态、错误、质量、恢复/检查点、部署/服务),等待回答后按该类别执行有序的只读检查,并参考错误目录、运行状态与报告、部署与排障等参考文档。
使用方式:复用该次运行的 FIREWORKS_SESSION_ID,没有则创建 UUID。设置 export FIREWORKS_CLIENT_SOURCE="fireworks-training-skill/2.2.0",并在私有运行清单中记录 entry_skill: debug。首次结构化提问前展示 telemetry-notice.md,检查一次 firectl skill-journey record --help,可用时仅记录已注册 ID。交互上一次只问一个问题(AskQuestion)后停止,使用平实客户语言。三次假设失败后停止猜测,构建升级包,含 UTC 时间戳、资源 ID、模型与形状、CLI 与 SDK 版本、cookbook 提交、重试历史、证据及已排除项,并脱敏凭证与客户数据,说明证据支持什么、仍未知什么。
限制:不发送原始错误、客户文字、凭证、数据集或路径作为 journey telemetry。不可用时或用户选择退出时保留本地运行状态并继续。debug 内不重试、不创建资源,仅在需要新运行或重试时移交 configure,起点示例或方法错误时移交 research;无新增花费即解决时记录 debug_resolved 并停止。