SuperAPI AI 工具集

kamae-review

编程与开发

查看项目

更新于 10-15 23:39

技能介绍

用途:对服务端 TypeScript 代码执行对抗式审查,检查是否符合 kamae 原则(可辨识联合、品牌类型、Result 错误处理、边界校验等)。知识库位于 ../kamae/,本技能仅链接而不复制。

主要能力与用法: 先加载适用规则,按优先级 glob 并 Read:.claude/rules/.md(工作树根的项目级覆盖)、~/.claude/rules/.md(用户全局偏好)、相对本 SKILL.md 的 ../../rules/defaults/*.md(插件默认)。读取每个文件的 YAML frontmatter,仅当 applies-to 为 kamae-review 或 * 时保留;按 name 分组,同组保留最高层级(1>2>3),同层取字典序最后的文件名;enabled: false 的可切换规则会停用对应检查;convention 规则设定项目级预期。无规则则全部检查生效。

审查流程:读取 ../kamae/SKILL.md 原则索引、按 package.json 匹配的验证库指南(zod.md/valibot.md/arktype.md)与 Result 库指南(neverthrow.md/byethrow.md/fp-ts.md/option-t.md),以及所引用的各主题文件;再阅读待审文件,按顺序走查 checklist:domain-modeling(1.x)、state-transitions(2.x)、error-handling(3.x)、boundary(4.1/4.2/4.4)、pii-protection(4.3)、declarative-and-tests(5.x/6.x)。

报告格式:每条违规给出位置(path:line)、问题原因(引用原则与风险)、修复方式(含纠正后代码示例);非违规但有改进空间者以同样格式标注为 suggestion。严重级别:High 为运行时错误或合规违规的直接原因(如 as、缺失 PII 保护、缺失 schema 校验、语义不同原始类型缺少品牌类型);Medium 为无效状态表示、错误处理不一致、缺少穷尽性、万能类型文件、领域模型用类、领域契约耦合基础设施类型;Low 为风格、可读性、边界正确性问题。

限制:资料未提供安装命令、平台支持、收费与价格、性能或效果数据,也未提供具体运行示例;使用前需准备好 kamae 知识库与规则文件。