القائمة
对应用代码进行审查：路由安全 → 认证授权 → i18n → 组件使用 → API 端点 / service workspace → 服务层 → 性能，并补充产品体验与交互走查；当需求涉及代码审查、规范化、质量检查时使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | hai-app-review |
| description | 对应用代码进行审查：路由安全 → 认证授权 → i18n → 组件使用 → API 端点 / service workspace → 服务层 → 性能，并补充产品体验与交互走查；当需求涉及代码审查、规范化、质量检查时使用。 |
| 项目 | 契约 |
|---|---|
| 能力 | 对应用代码进行审查：路由安全 → 认证授权 → i18n → 组件使用 → API 端点 / service workspace → 服务层 → 性能，并补充产品体验与交互走查；当需求涉及代码审查、规范化、质量检查时使用。 |
| 适用场景 | 当任务与 hai-app-review 的能力描述匹配，并且需要遵循本 Skill 的流程和边界时 |
| 输入 | 用户指定的审查范围、代码/差异、仓库规范与可复现证据 |
| 输出 | 按优先级排列的问题、影响、定位和修正建议；仅在用户要求时实施修改 |
| 限制 | 不把风格偏好当缺陷，不猜测未读取的实现，不在审查请求中擅自发布或改动外部状态 |
面向 AI 助手的应用代码审查指南。用于审查使用 hai-framework 构建的 SvelteKit 应用、纯 Svelte/Vite 客户端与 API service workspace。本技能也是 TDD Refactor 阶段的执行入口。
tests/ 目录）e2e/ 目录）pnpm test 单元测试全部通过pnpm test:e2e E2E 测试全部通过hooks.server.ts 仅做中间件编排（初始化、i18n、handle hook），无业务逻辑+page.server.ts / +server.ts 仅做请求处理（守卫 → 校验 → 调用服务 → 响应）$lib/server/services/result.successtry/catch 来处理框架模块返回的错误（模块 API 不抛异常，统一返回 HaiResult<T>）// ❌ 重新包装
const result = await reldb.sql.query(sql)
if (!result.success) {
return { success: false, error: { code: 'QUERY_FAILED', message: result.error.message } }
}
// ✅ 直接透传
const result = await reldb.sql.query(sql)
if (!result.success)
return result
load 函数有 kit.guard.* 守卫kit.validate.*）console.log，统一使用 core.logger| 场景 | 级别 |
|---|---|
| 读操作 / 查询 | debug |
| 写操作进入 | debug |
| 写操作成功 | info |
| 校验失败 | warn |
| 系统异常 | error |
| 初始化完成 / 关闭 | info |
| 安全操作（登录/登出） | info（成功）/ warn（失败） |
{ error } 或 { reason }any，不确定用 unknown + 缩窄HaiResult<T> / Promise<HaiResult<T>>）$lib/paraglide/messages.js）src/lib/paraglide 生成文件@h-ai/ui 组件内置翻译，不传入翻译 props$props()、$state()、$derived()、$effect()）createEventDispatcher）core → db → cache → iam → ...$lib/server/init.ts 统一管理config/_<module>.yml 约定审查完成后按顺序执行：
pnpm typecheckpnpm lintpnpm test（单元测试）pnpm --filter <app-name> test:e2e（E2E 测试）优先使用 pnpm --filter <app-name> 指定应用。
hai-build：项目架构总览与 TDD 工作流导航hai-app-create：TDD 驱动的应用功能创建规范hai-app-tests：TDD 测试规范（Red 阶段详细指引）Use when: using @h-ai/ai, LLM calls, chat completion, tool calling, function calling, MCP server, streaming, memory management, context compression, summarization, token estimation, RAG, knowledge base, AI client, embeddings, reasoning, rerank, file parsing, speech recognition ASR, speech synthesis TTS, audio, A2A agent-to-agent. 使用 @h-ai/ai 进行 LLM 调用、工具定义、MCP 服务器、流式处理、记忆管理、上下文压缩、知识库、推理引擎、Rerank、文件解析、语音识别与合成、A2A 与会话持久化。
Use when: using @h-ai/ai for LLM calls, tools, MCP, streaming, memory/context, RAG, audio, A2A, or the AI client. 当需求涉及 AI 对话、工具、Audio、会话、知识库或 AI 客户端时使用。
Use when: creating or extending apps in hai-framework, adding routes, pages, API endpoints, service workspaces, mobile app, H5 app, admin console. 在 hai-framework 中创建或扩展应用或 API service workspace，包含路由、API 端点、typed contract、服务层与 UI 脚手架代码。
Use when: creating a new module, new package, scaffold, add sub-feature, add provider, create repository, module structure, tsup config, error codes, NotInitializedKit pattern. 在 hai-framework 中创建新模块（package）。
Use when: reviewing app code in hai-framework, auditing app quality, checking app conventions, reviewing routes, reviewing API service workspaces, app security, app i18n review. 对 hai-framework 应用层代码进行审查：路由安全 → 认证授权 → i18n → 组件使用 → API 端点 / service workspace → 服务层 → 性能。
Use when: reviewing code, code review, auditing module quality, checking hai-framework conventions, verifying HaiResult<T> usage, reviewing module structure, PR review, checking naming consistency, verifying NotInitializedKit pattern, auditing performance, security, distributed systems. 对 hai-framework 模块进行全维度代码审查：架构 → 命名 → 类型 → 注释 → 性能 → 分布式 → 安全 → 日志 → 测试 → 文档。