用途:该技能用于在 Flows 应用中查找并修复正确性与错误处理问题。可针对指定参数($ARGUMENTS)或整个应用执行,逐步搜索问题并就地修复,仅报告无法自动修复的问题。
主要能力(按步骤):
- 梳理数据流并修复已知缺陷:读取 main.tsx/App.tsx、hooks、contexts、api、services 等文件,检查异步数据源失败、加载中、空结果时的表现;用 grep 查找 TODO/FIXME/HACK 等标记并修复关键路径问题,修复后移除注释,无法修复则改为安全失败模式。
- 添加顶层错误边界:检查 ErrorBoundary/componentDidCatch/getDerivedStateFromError,缺失时创建 ErrorFallback 并包裹主内容,必要时安装 react-error-boundary(pnpm add react-error-boundary)。
- 为未处理的异步函数加 try/catch:查找 async 函数与无 .catch() 的 .then(),为 TanStack Query 的 useQuery/useMutation 补充 isError 处理。
- 为组件补充加载、错误、空三种状态,按 loading→error→empty 顺序插入。
- 对外部数据做类型收窄:对 JSON.parse、localStorage、useSearchParams 使用 Zod safeParse 或空值回退,禁止用 as 断言绕过运行时安全。
- 修复 null/undefined 与不安全数组访问:使用可选链、空值合并、.at() 等。
- 为 useEffect 添加清理函数:针对事件监听、定时器、流、fetch、订阅等模式补充清理或 AbortController。
- 添加边界情况防护:空数据、单项、分页、并发/过期请求、离线;Atlas 工具 execute 函数需校验参数。
- 输出结构化报告:列出各步骤修复内容与剩余问题(严重级别、文件、行号、问题、状态),无问题则注明。
使用方式:在 Flows 应用上下文中调用该技能,可传入目标参数;技能会读取文件、执行 grep 搜索并直接写回修改。
适用场景:Flows 应用的正确性与错误处理修复、代码审查后的自动整改。
限制:涉及重大架构变更或需产品决策的问题不会自动修复,仅报告;资料未提供具体收费、平台支持范围等信息。