SuperAPI AI 工具集

kamae

编程与开发

查看项目

更新于 10-16 06:20

技能介绍

用途:Kamae 是面向服务端 TypeScript 的领域建模指南,帮助按函数式思路组织领域代码,覆盖判别联合、纯状态转换、Result 类型与 schema 校验等主题。

主要能力:资料列出六个主题文件,按需阅读:类型驱动领域建模(domain-modeling.md)、状态转换(state-modeling.md)、错误处理(error-handling.md)、边界防御(boundary-defense.md)、声明式风格(declarative-style.md)、测试数据(test-data.md)。领域建模主张以 kind 作为统一判别字段、使用 type 而非 interface、Companion Object 模式、通过项目校验库实现 branding、Readonly<>、每文件一个概念,并将读契约(resolver)与写契约(store)分离。错误处理以用例相关的 Result 错误联合建模业务失败,意外基础设施错误交由应用错误边界。边界防御要求对所有外部输入做运行时校验,禁止类型断言(仅允许 as const 与 as const satisfies Type),对 PII 使用 Sensitive<T>。

使用方式:先按优先级读取规则:工作树根部 .claude/rules/.md、~/.claude/rules/.md、相对本 SKILL.md 的 ../../rules/defaults/*.md;读取 frontmatter,跳过 applies-to 非 kamae 或 * 的规则;按 name 取最高层级(1>2>3),同层取文件名字典序最后者。随后读取 package.json 检测库:Result 库优先级 neverthrow > byethrow > fp-ts > option-t;校验库优先级 zod > valibot > arktype;未检测到需先询问用户。之后仅按任务读取相关主题文件,示例在 examples/ 中按需查阅。若同包已有稳定代码风格,优先沿用本地约定。

适用场景与限制:适用于服务端 TypeScript 的领域层设计。资料称这些原则是建议而非硬性规则,偏离时需在注释中说明理由;同时缺少安装命令、运行方式、平台与收费信息,暂未提供。