煋鉴 Xinpect 代码审查专家
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-l7548nxs/xinpect-code-review-pro。
技能介绍
解决什么问题
多数代码审查要么依赖人工走查,要么交给通用 LLM 顺带看一遍。前者在规则覆盖上随团队经验波动,后者容易漏掉埋点缺失、事务边界、并发竞态这类需要结构化检查的点。煋鉴 Xinpect 的做法是把规则做成可量化的引擎,而不是让模型自由发挥。
- 规则散落在 9 个"大脑"中,覆盖安全、性能、可观测性、架构、业务逻辑和小程序专项,总计
1050+条,每条 issue 给出严重等级、文件、行号和修复建议。 - 支持 Python / JavaScript / TypeScript / Java / Go / PHP / Ruby / CSS / HTML 以及微信小程序(WXML / WXSS)。
- v5.9.0 补齐了可观测性(日志规范、监控埋点、链路追踪、告警配置 20 条)、并发安全(死锁、竞态、线程安全 8 条)、测试质量(覆盖率、边界用例、Mock 规范 10 条)与数据一致性(事务、幂等、最终一致性 8 条)。
它是怎么工作的
- 上传代码:把项目打成 zip,指定
level发起扫描。quick只跑语法与安全两个大脑,standard跑 6 个核心大脑,full跑完 9 个大脑的全部规则。 - X402 支付:服务端返回
402时,从响应头取X-Out-Trade-No,由平台的支付插件完成 X402 付费流程。 - 重试拉结果:支付成功后用相同的
file和level重新请求,凭证放在请求头而不是请求体里,避免改动扫描参数。 - 结构化输出:成功时返回
code = SUCCESS和 issue 列表;支付未完成返回NOT_PAID,服务异常返回REFUNDED并自动退款,此时应终止流程并告知用户。
适用边界与注意点
- 前置检查不可省:调用前必须确认 Agent 环境具备 X402 付费能力,否则应直接提示"当前环境暂不支持付费能力,无法使用专业版扫描",而不是走半程再失败。
- 体积与耗时:单个 zip 包上限
50MB,扫描超时 5 分钟;大型项目建议先用quick级别快速定位,再按需升级。 - 业务逻辑与 AI 语义分析是付费核心卖点,规则之外的项目上下文仍需要开发者自己判断。
- 结果里的
suggestion是修复方向,不等于可直接合并的补丁,复杂修复仍需结合业务验证。
使用场景
- 微信小程序提审前,需要扫描 TDesign 组件契约、页面可达性与游离页面。
- 支付服务合并后,要检查并发安全、事务与幂等相关的数据一致性。
- 上线前想按日志、监控埋点和告警配置评估现有可观测性是否达标。
- CI 前置环节需要先跑 quick 扫描,优先查看安全与依赖漏洞。
适合人员
- 后端工程师:希望全量扫描安全、并发与数据一致性问题后再发版。
- 前端工程师:需要在小程序提审前定位组件契约与页面可达性缺陷。
- 测试工程师:想检查单测覆盖率、边界用例和 Mock 规范是否达标。
- SRE 工程师:准备按日志与监控埋点规则补齐线上可观测性。