메뉴
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 → 服务层 → 性能。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
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 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 模块进行全维度代码审查：架构 → 命名 → 类型 → 注释 → 性能 → 分布式 → 安全 → 日志 → 测试 → 文档。
Use when: building UI with @h-ai/ui, including Svelte 5 Runes components, DaisyUI/Bits UI integration, forms, tables, dialogs, mobile components, theme switching, Markdown/AI output rendering, and Mermaid document/code previews. 使用 @h-ai/ui 构建界面、多端组件、主题系统、AI 输出展示与 Mermaid 文档/代码预览时使用。
SOC 직업 분류 기준
| name | hai-review-app |
| description | 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 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 → 服务层 → 性能。 |
| 适用场景 | 当任务与 hai-review-app 的能力描述匹配，并且需要遵循本 Skill 的流程和边界时 |
| 输入 | 用户指定的审查范围、代码/差异、仓库规范与可复现证据 |
| 输出 | 按优先级排列的问题、影响、定位和修正建议；仅在用户要求时实施修改 |
| 限制 | 不把风格偏好当缺陷，不猜测未读取的实现，不在审查请求中擅自发布或改动外部状态 |
面向 AI 助手的应用审查指南。适用于
apps/下的 SvelteKit 应用、纯 Svelte/Vite 客户端与 API service workspace；审查基准参照hai-create-app。
hai-create-app 确认基准。hai-create-app §2+layout.server.ts 守卫（检查 locals.session）kit.guard.require / kit.guard.check）kit.client.create 自动附加+page.svelte 使用 $props() 接收 data，类型正确+page.server.ts 并行加载无依赖数据（Promise.all）kit.validate.body / query / params）kit.guard.requirekit.response.*（不手动构造 Response）kit.response.fromError 转换lib/server/schemas/src/lib/paraglide/ 生成文件{page}_{element}）{@html} 仅用于受控 HTML（已 sanitize）anysetPermissionContext() + usePermission()以真实用户身份从入口走到目标页面，逐路径确认体验闭环。
| 状态 | 检查 |
|---|---|
| Loading | 骨架屏或 spinner，相关按钮禁用防重复提交 |
| Empty | 友好空态插画 + 引导操作（"新建第一个"） |
| Error | 具体可操作的提示（"请输入有效邮箱"，非"输入有误"），含重试 |
| Success | 即时反馈（toast / inline）+ 后续动作引导 |
? 占位符）eval / Function / innerHTML（受控 SVG 除外）../ 逃逸PUBLIC_ 前缀变量无敏感信息$env/static/privateaccessToken（优先使用 httpOnly Cookie 会话）localStorage / sessionStorage / kit.auth.createTokenStore 持久化敏感 TokenPromise.all）### {等级} 问题标题
- 位置：`src/routes/xx/+page.server.ts` L42
- 问题：具体描述
- 风险：后果
- 建议：改进方案
| 等级 | 含义 | 处理 |
|---|---|---|
| P0 | 安全漏洞 / 数据泄露 / 服务崩溃 | 立即修复 |
| P1 | 权限绕过 / 认证缺失 / 错误吞没 | 本轮修复 |
| P2 | 性能瓶颈 / 缺少校验 / i18n 遗漏 | 建议修复 |
| P3 | 风格 / 命名 / 结构 | 顺手修复 |