用途：分析现有 Next.js 路由架构，判断各路由应使用 Server Actions 还是传统 API 路由，并给出重构建议与迁移计划。
主要能力：扫描 app 目录中的路由处理器与 Server Actions，识别请求/响应模式、认证、重验证与外部 API 使用；依据决策矩阵给出推荐；对需重构的路由提供逐步迁移说明、前后代码示例及破坏性变更提示。
使用方式：运行 python scripts/analyze_routes.py --path /path/to/app --output analysis-report.md 生成分析报告，再参考 references/decision_matrix.md 的决策标准逐条评估。
适用场景：表单提交、带 revalidatePath()/revalidateTag() 的数据变更、简单 CRUD、RSC 认证、文件上传、乐观更新适合 Server Actions；外部 API 代理、Webhook、非 POST 操作、第三方集成、公开 API、自定义响应头、SSE/流式响应适合 API 路由。
限制：资料未提供具体版本要求、性能基准或收费信息；迁移复杂度与收益需结合实际代码判断。