用途:逆向分析遗留应用的隐式业务规则与外部行为,确保迁移到现代架构后行为一致,适合在系统重构或现代化改造前做审计。
主要能力:
- 认证与授权分析:定位 Passport、session 或 JWT 配置(如 config/passport.js),记录登录策略(Local、OAuth 等)与必填字段;梳理访问控制逻辑,如 requiresRole('admin')、isOwner(resource_id) 等角色或所有权校验。
- 副作用映射:识别主请求/响应周期之外的动作,包括 Stripe 支付、Twilio 短信、SendGrid 邮件等外部服务,mailer/ 或 services/email/ 中的自动通知,以及 Multer 等文件上传配置及存储位置(本地磁盘或云存储)。
- 全局中间件分析:检查 app.js 或 config/express.js,记录 helmet、cors、自定义日志、csurf 等中间件,判断哪些仍适用于现代 Next.js API。
- 现代化建议:指出迁移到现代技术栈的潜在坑点,例如 Next-Auth 与 Passport 的差异,并推荐遗留副作用的现代替代方案(如从本地文件存储转向 S3/Uploadthing)。
使用方式:按五步清单推进——分析认证与授权流程、映射副作用、分析全局中间件、撰写现代化建议、生成 Business_Logic_Rules.md;成果写入 docs/legacy-audit/Business_Logic_Rules.md,并识别逻辑一致性探针(例如“在缺少必要 OAuth 会话时提交表单,验证重定向循环与遗留系统一致”),追加到 docs/verification/Verification_Plan.md。
限制:本技能定位为审计与文档整理,不实际执行代码修改;效果依赖目标代码库中相关配置是否可被识别。具体安装命令、平台支持与收费信息暂未提供。