SuperAPI AI 工具集

game-review

测试与质量

查看项目

更新于 10-15 21:41

技能介绍

用途:对现有游戏代码做只读审计,按设计原则检查工程实现、叙事一致性与 MVP 范围漂移,输出结构化报告,不修改任何代码。

主要能力:先静默加载上下文(读取 docs/mvp-first-draft.md、docs/build-registry.md),根据用户消息确定审查范围(指定组件或路径则聚焦 src/[component]/,否则审查整个 src/),并扫描目标范围识别技术域,按域套用相关技能(如检测到 Auth 用 betterauth-integration,Stripe 用 stripe-game-payments,WebSocket 用 game-state-sync,Redis 用 redis-game-patterns,BullMQ 用 bullmq-game-queues,任务/叙事用 quest-narrative-coherence,数据库/Drizzle 用 postgres-game-schema,匹配用 matchmaking-system,分析用 gameplay-analytics)。

检查项:工程审查覆盖状态权威(如 WebSocket 信任客户端 userId、客户端消息直接改状态)、数据库模式(原始 SQL 模板、软删除列、JSONB 使用、索引)、认证会话(从请求体取 userId、JWT 过期校验、限流、角色存储)、支付(成功重定向触发履约、Webhook 签名校验、客户端密钥、幂等)、BullMQ(重试、退避、清理)、Redis(键命名、TTL、排行榜更新)与通用安全(硬编码密钥、eval、输入校验)。叙事一致性检查对比 docs/world-lore.md 与 docs/quest-registry.md,标记代码中未注册的角色/任务/阵营/地点。范围漂移检查读取 MVP 草案第 10 节,标记已推迟功能的实现及 build-registry 中超出构建序列的组件。

使用方式:作为技能调用,提供组件名或路径以限定范围;报告按严重级别(🔴 严重、🟡 警告、🟢 建议)分组,每条含文件路径、近似行号、问题、修复建议与对应技能引用,末尾给出后续步骤。

限制:只读审计,绝不修改代码;不报告误报,可疑但可接受的情况跳过或降级;每条发现必须关联技能;若缺少 docs/quest-registry.md 或 docs/mvp-first-draft.md,相应阶段会跳过并提示先运行 game-quest 或 game-architect 技能。