SuperAPI AI 工具集

hyper-architecture-hono

编程与开发

查看项目

更新于 11-04 22:28

技能介绍

该技能用于对 Hono 应用实施架构约束。使用前需先确认目标为 Hono 项目(检查 package.json 中的 hono 依赖、源码中的 hono 导入、createFactory、testClient、OpenAPIHono 等标识);若不存在这些标识,则不应强制套用 Hono 规则。

主要检查范围包括:项目结构与依赖方向、路由组合与挂载顺序、处理器提取与类型化上下文、中间件顺序与 Bindings/Variables、参数/查询/JSON/表单验证、数据库客户端与仓储边界、Drizzle schema 与迁移、OpenAPI/Swagger 契约、错误处理与响应整形、testClient 与 hc<AppType> 类型化 RPC、运行时适配器与入口点、命名与 TypeScript 约定。

使用方式:先读取 architecture-rules.md,再按受影响面打开对应主题规则文件(project-structure、routes、handlers、middleware、validation、database、openapi、errors、testing-rpc、platform、conventions),必要时查阅官方 Hono 与 Drizzle 文档。支持三种参数范围:默认只审查并修复请求或触及的范围;“전체 수정 / full fix”为全量修复模式,扫描整个 Hono 应用并修复安全、局部、可逆、可验证的问题;“공식 기본만 / official defaults only”以官方 Hono 行为为准,将 Hypercore 专属严格约定降级为可选发现。

可自动修复的低风险项包括:将驼峰或帕斯卡命名的源码文件夹/文件改为 kebab-case 并更新引用、为触及路由补充验证中间件、补充类型化 AppType 导出、集中路由挂载、将未类型化处理器改为 createFactory()、补充 app.onError()、把运行时适配器导入移出处理器、将直接数据库调用移入服务或仓储、为已有规范补充 OpenAPI 元数据等。批量重命名、整层重写、更换验证库、破坏现有 RPC 客户端、切换运行时适配器/数据库供应商/ORM/方言、生成或应用或删除生产迁移、重命名 schema 表列索引等高风险操作不自动执行。

完成后运行项目相关检查与最终清单,输出以韩语为主,每条发现标注为官方规则或 Hypercore 专属约定,并记录改动文件、验证证据与剩余风险。该技能自包含,不依赖其它技能路径或外部编排。