SuperAPI AI 工具集

adversarial-ts-patterns

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:这是面向 TypeScript 与 React 应用代码的设计模式使用门禁,输出通过/不通过的结果,而非改进建议。评审由单个盲审子代理以对抗式立场,逐条对照该门禁规则判断;仅当每条规则为 PASS 或 N/A 时工作才通过。该技能只渲染裁决,从不修复代码。

主要能力:双向审查。既查过度抽象,例如把 Java/C# 的四人帮与企业级机制搬进惯用 TypeScript(函数、模块、标签联合即可胜任之处);也查建模不足,例如布尔标志生命周期、effect 链、手工同步的派生状态、静默默认分支等“非法状态可编译”的隐式状态机。规则分六类:state- 状态建模与状态机;create- 创建型端口;behave- 行为型端口;layer- 企业分层;react- React 组合;oo- 面向对象仪式。

使用方式:先确定评审目标(diff、文件集或 PR),记录 ref 与路径,并将仓库根目录写入目标描述,因为 layer 相关规则需搜索 diff 之外的实现与注册。加载规则:读取 references/_sections.md 及 references/ 下全部规则文件。填写 references/reviewer-prompt.md 组成评审提示,必须完全自包含,评审者看不到对话历史。派发一个盲审 Task 子代理,其全部输入即该提示。按失败即失败渲染:评审者的结构化输出即裁决;全部 PASS 或 N/A 才 PASS,任一 FAIL 即不通过;不做平均、不权衡严重度、不豁免规则,轻微 FAIL 也是 FAIL。若返回 GATE NOT APPLICABLE 则停止并报告,不给裁决。通过后填写 assets/templates/verdict.md;FAIL 时把“为通过所缺内容”汇总为修复清单,含位置并按类别重要性排序,每条 FAIL 规则须给出可照做的具体改动。

适用场景:TypeScript/React 差异或功能即将合并,需要客观 PASS/FAIL;代理(Claude、Codex)编写的代码需要独立核查是否复现 Java/C# 训练数据惯用法;从其他技术栈迁移后的架构需要审计;组件或 store 状态自然增长,需在发布前发现矛盾布尔、effect 链、非穷尽匹配等失败模式。

限制:不适用于非 TypeScript 代码库,评审提示前置条件会以 GATE NOT APPLICABLE 中止;当用户想要解释与重构而非裁决时不应使用,那属于 implementation-design-patterns 与 implementation-functional-patterns 的职责。React 专属规则在非 React 的 TypeScript 项目中记为 N/A,其余规则适用于任何 TypeScript 应用。若同一规则在未变更目标上多次评审结果翻转,或人工依据证据推翻裁决,视为规则可判定性缺陷,应记入 gotchas.md 并强化规则而非推翻门禁。