async-task-pattern
Installation
SKILL.md
异步任务模式规范
当一个操作可能跑超过 10 秒,必须改成 triggerAsync() + getStatus() 的异步状态机模式。
不要让用户盯着一个会超时的 loading 转圈,更不要让他点第二下。
与
query-performance-safety配合:先用后者把同步性能压到能跑完的范围;只有"再优化也压不到 10s 以内"时,才走本规范。
触发条件
只要满足任一条件,就属于本 skill 的覆盖范围:
- 单次操作处理数据量 ≥ 1000 条(批量导入、全表扫描、跨租户聚合)
- 链路里有远程 API 批量调用,且 batch size × 单次延迟 > 5s
- 历史上同步实现已经出过 504/502/30s timeout
- 用户描述里出现"卡住"、"转圈很久"、"点完没反应"