用途:当智能体重复犯错、长对话引发幻觉、上下文窗口已满,或需要移交新智能体时,提供结构化恢复流程。
三种方案:
- Escalate(交接报告):智能体卡住无法解决时使用。先撤销损坏改动(git status、git checkout -- .),再生成 docs/escalation_report.md,含损坏报告(原始目标、确切错误、失败方法、涉及文件、最佳猜测诊断)、完整文件内容、给编排者的指令;随后开启新会话并粘贴报告。
- Migrate(上下文快照):对话陈旧需新会话沿用上下文时使用。自动检测项目信息(读取 docs/Project_Requirements.md、git log --oneline -20、gh issue list --state open --limit 10 --json number,title、docs/Coding_Guidelines.md),生成 docs/migration_snapshot.md,包含新 AI 身份、项目详情、里程碑、当前状态、关键文件与首个动作。
- Reset(会话中重置):智能体出错但可恢复时使用,含硬性检查清单(编辑前是否 view_file 读取目标文件、是否精确复制内容含空白、单次编辑是否少于 50 行、变量名是否在作用域内、props 是否解构),并列出常见错误与修正,如重复行、缺失解构、JSX 破损、幽灵变量、编辑偏移漂移。
文件编辑协议:view_file_outline 理解结构,view_file 精确范围复制内容,最小范围编辑,下次编辑前重新检查文件。
完成校验:声明“done”前须运行 npx tsc --noEmit 通过,确认无重复声明、无缺失导入、任务确实解决;若修复 3 次后仍报错,改用 Escalate。
限制:资料未说明该技能的安装方式、依赖版本、平台支持范围与收费情况。