该技能是 Spectacular 工作流的排错参考，仅在 execute 命令执行失败或结果异常时查阅，不属于正常执行流程。适用场景包括：顺序或并行阶段执行失败、并行智能体失败或未完成、堆叠时出现合并冲突、worktree 创建失败、找不到主 worktree，以及修复后需要恢复执行。
内容按错误类别组织。顺序阶段失败时，需查看错误输出，进入 .worktrees/{runid}-main 用 git status 与 git log --oneline -5 检查状态，必要时手动修复并运行 npm test、npm run lint、npm run build 等质量检查，任务完成但未建分支时可用 gs branch create {runid}-task-{phase}-{task}-{name} 创建，再恢复执行。并行阶段智能体失败提供四种处置：在既有分支修复、创建堆叠修复分支、通过 git worktree remove 删除后重启智能体、或跳过失败任务继续。合并冲突需先核对两任务改动的文件是否重叠，确认并行任务存在文件依赖后手动合并，并把后续计划改为顺序执行。worktree 找不到通常因未先运行 /spectacular:spec，需先执行该命令创建工作区，再依次运行 /spectacular:plan 和 /spectacular:execute。worktree 创建失败常见原因有路径已存在、当前分支有未提交改动、工作目录不干净、在错误目录操作，可分别用 rm -rf、git worktree prune、git stash 或提交、切回主仓库等方式处理。
文档还给出诊断命令，如 git worktree list、git branch | grep "{runid}-"、gs log short，以及恢复策略：手动修复后继续、重置阶段重试、或放弃功能并清理 worktree 与分支。预防方面建议执行前校验任务独立性与文件路径、使用 validating-setup-commands 技能、正确使用 executing-parallel-phase 与 executing-sequential-phase、并在每阶段后确认分支与堆叠结构。该技能仅提供排错指导，具体收费、平台与效果等资料暂未提供。