@h-ai/cli 0.1.0-alpha.19 → 0.1.0-alpha.21

package/templates/features/iam/routes-admin/(auth)/+layout.svelte.hbs

@@ -1,5 +1,5 @@
 {{!-- 认证布局（登录/注册共用） --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * 认证布局（登录/注册共用）
    */
@@ -9,12 +9,12 @@
     children: Snippet
   }
 
-  let { children }: Props = $props()
+  const { children }: Props = $props()
 </script>
 
-<div class="min-h-screen flex items-center justify-center bg-base-200">
-  <div class="card w-full max-w-md bg-base-100 shadow-xl">
-    <div class="card-body">
+<div class='min-h-screen flex items-center justify-center bg-base-200'>
+  <div class='card w-full max-w-md bg-base-100 shadow-xl'>
+    <div class='card-body'>
       {@render children()}
     </div>
   </div>

package/templates/features/iam/routes-admin/(auth)/auth/login/+page.svelte.hbs

@@ -1,18 +1,21 @@
 {{!-- Admin 登录页面 --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * 登录页面
    */
+  import { resolve } from '$app/paths'
 {{#if hasI18n}}
   import * as m from '$lib/paraglide/messages'
 {{/if}}
+  import { Alert, Button, FormField, Input } from '@h-ai/ui'
 
   let username = $state('')
   let password = $state('')
   let error = $state('')
   let loading = $state(false)
 
-  async function handleLogin() {
+  async function handleLogin(event: SubmitEvent) {
+    event.preventDefault()
     error = ''
     loading = true
     try {
@@ -24,20 +27,23 @@
       const data = await res.json()
       if (data.success) {
         window.location.href = '/admin'
-      } else {
+      }
+      else {
 {{#if hasI18n}}
         error = data.error?.message || m.auth_login_failed()
 {{else}}
         error = data.error?.message || '登录失败'
 {{/if}}
       }
-    } catch {
+    }
+    catch {
 {{#if hasI18n}}
       error = m.auth_error_network()
 {{else}}
       error = '网络错误'
 {{/if}}
-    } finally {
+    }
+    finally {
       loading = false
     }
   }
@@ -52,47 +58,43 @@
 </svelte:head>
 
 {{#if hasI18n}}
-<h2 class="card-title justify-center mb-4">{m.auth_login_title()}</h2>
+<h2 class='text-2xl font-bold text-center mb-6'>{m.auth_login_title()}</h2>
 {{else}}
-<h2 class="card-title justify-center mb-4">登录</h2>
+<h2 class='text-2xl font-bold text-center mb-6'>登录</h2>
 {{/if}}
 
 {#if error}
-  <div class="alert alert-error mb-4">
-    <span>{error}</span>
-  </div>
+  <Alert variant='error' class='mb-4'>{error}</Alert>
 {/if}
 
-<form onsubmit={(e) => { e.preventDefault(); handleLogin() }} class="space-y-4">
-  <div class="form-control">
-{{#if hasI18n}}
-    <label class="label" for="username"><span class="label-text">{m.auth_label_username()}</span></label>
-{{else}}
-    <label class="label" for="username"><span class="label-text">用户名</span></label>
-{{/if}}
-    <input id="username" type="text" class="input input-bordered w-full" bind:value={username} required />
-  </div>
-  <div class="form-control">
-{{#if hasI18n}}
-    <label class="label" for="password"><span class="label-text">{m.auth_label_password()}</span></label>
-{{else}}
-    <label class="label" for="password"><span class="label-text">密码</span></label>
-{{/if}}
-    <input id="password" type="password" class="input input-bordered w-full" bind:value={password} required />
-  </div>
-  <button type="submit" class="btn btn-primary w-full" disabled={loading}>
+<form onsubmit={handleLogin} class='space-y-4'>
 {{#if hasI18n}}
+  <FormField label={m.auth_label_username()} required>
+    <Input id='username' type='text' bind:value={username} required />
+  </FormField>
+  <FormField label={m.auth_label_password()} required>
+    <Input id='password' type='password' bind:value={password} required />
+  </FormField>
+  <Button type='submit' variant='primary' loading={loading} class='w-full'>
     {loading ? m.auth_login_loading() : m.auth_login_submit()}
+  </Button>
 {{else}}
+  <FormField label='用户名' required>
+    <Input id='username' type='text' bind:value={username} required />
+  </FormField>
+  <FormField label='密码' required>
+    <Input id='password' type='password' bind:value={password} required />
+  </FormField>
+  <Button type='submit' variant='primary' loading={loading} class='w-full'>
     {loading ? '登录中...' : '登录'}
+  </Button>
 {{/if}}
-  </button>
 </form>
 
-<div class="text-center mt-4">
+<div class='text-center mt-4'>
 {{#if hasI18n}}
-  <a href="/auth/register" class="link link-primary text-sm">{m.auth_login_to_register()}</a>
+  <a href={resolve('/auth/register', {})} class='link link-primary text-sm'>{m.auth_login_to_register()}</a>
 {{else}}
-  <a href="/auth/register" class="link link-primary text-sm">没有账号？立即注册</a>
+  <a href={resolve('/auth/register', {})} class='link link-primary text-sm'>没有账号？立即注册</a>
 {{/if}}
 </div>

package/templates/features/iam/routes-admin/(auth)/auth/register/+page.svelte.hbs

@@ -1,11 +1,13 @@
 {{!-- Admin 注册页面 --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * 注册页面
    */
+  import { resolve } from '$app/paths'
 {{#if hasI18n}}
   import * as m from '$lib/paraglide/messages'
 {{/if}}
+  import { Alert, Button, FormField, Input } from '@h-ai/ui'
 
   let username = $state('')
   let email = $state('')
@@ -14,7 +16,8 @@
   let error = $state('')
   let loading = $state(false)
 
-  async function handleRegister() {
+  async function handleRegister(event: SubmitEvent) {
+    event.preventDefault()
     error = ''
     if (password !== confirmPassword) {
 {{#if hasI18n}}
@@ -34,20 +37,23 @@
       const data = await res.json()
       if (data.success) {
         window.location.href = '/auth/login'
-      } else {
+      }
+      else {
 {{#if hasI18n}}
         error = data.error?.message || m.auth_register_failed()
 {{else}}
         error = data.error?.message || '注册失败'
 {{/if}}
       }
-    } catch {
+    }
+    catch {
 {{#if hasI18n}}
       error = m.auth_error_network()
 {{else}}
       error = '网络错误'
 {{/if}}
-    } finally {
+    }
+    finally {
       loading = false
     }
   }
@@ -62,63 +68,55 @@
 </svelte:head>
 
 {{#if hasI18n}}
-<h2 class="card-title justify-center mb-4">{m.auth_register_title()}</h2>
+<h2 class='text-2xl font-bold text-center mb-6'>{m.auth_register_title()}</h2>
 {{else}}
-<h2 class="card-title justify-center mb-4">注册</h2>
+<h2 class='text-2xl font-bold text-center mb-6'>注册</h2>
 {{/if}}
 
 {#if error}
-  <div class="alert alert-error mb-4">
-    <span>{error}</span>
-  </div>
+  <Alert variant='error' class='mb-4'>{error}</Alert>
 {/if}
 
-<form onsubmit={(e) => { e.preventDefault(); handleRegister() }} class="space-y-4">
-  <div class="form-control">
-{{#if hasI18n}}
-    <label class="label" for="username"><span class="label-text">{m.auth_label_username()}</span></label>
-{{else}}
-    <label class="label" for="username"><span class="label-text">用户名</span></label>
-{{/if}}
-    <input id="username" type="text" class="input input-bordered w-full" bind:value={username} required />
-  </div>
-  <div class="form-control">
-{{#if hasI18n}}
-    <label class="label" for="email"><span class="label-text">{m.auth_label_email()}</span></label>
-{{else}}
-    <label class="label" for="email"><span class="label-text">邮箱</span></label>
-{{/if}}
-    <input id="email" type="email" class="input input-bordered w-full" bind:value={email} required />
-  </div>
-  <div class="form-control">
-{{#if hasI18n}}
-    <label class="label" for="password"><span class="label-text">{m.auth_label_password()}</span></label>
-{{else}}
-    <label class="label" for="password"><span class="label-text">密码</span></label>
-{{/if}}
-    <input id="password" type="password" class="input input-bordered w-full" bind:value={password} required />
-  </div>
-  <div class="form-control">
-{{#if hasI18n}}
-    <label class="label" for="confirmPassword"><span class="label-text">{m.auth_label_confirm_password()}</span></label>
-{{else}}
-    <label class="label" for="confirmPassword"><span class="label-text">确认密码</span></label>
-{{/if}}
-    <input id="confirmPassword" type="password" class="input input-bordered w-full" bind:value={confirmPassword} required />
-  </div>
-  <button type="submit" class="btn btn-primary w-full" disabled={loading}>
+<form onsubmit={handleRegister} class='space-y-4'>
 {{#if hasI18n}}
+  <FormField label={m.auth_label_username()} required>
+    <Input id='username' type='text' bind:value={username} required />
+  </FormField>
+  <FormField label={m.auth_label_email()} required>
+    <Input id='email' type='email' bind:value={email} required />
+  </FormField>
+  <FormField label={m.auth_label_password()} required>
+    <Input id='password' type='password' bind:value={password} required />
+  </FormField>
+  <FormField label={m.auth_label_confirm_password()} required>
+    <Input id='confirmPassword' type='password' bind:value={confirmPassword} required />
+  </FormField>
+  <Button type='submit' variant='primary' loading={loading} class='w-full'>
     {loading ? m.auth_register_loading() : m.auth_register_submit()}
+  </Button>
 {{else}}
+  <FormField label='用户名' required>
+    <Input id='username' type='text' bind:value={username} required />
+  </FormField>
+  <FormField label='邮箱' required>
+    <Input id='email' type='email' bind:value={email} required />
+  </FormField>
+  <FormField label='密码' required>
+    <Input id='password' type='password' bind:value={password} required />
+  </FormField>
+  <FormField label='确认密码' required>
+    <Input id='confirmPassword' type='password' bind:value={confirmPassword} required />
+  </FormField>
+  <Button type='submit' variant='primary' loading={loading} class='w-full'>
     {loading ? '注册中...' : '注册'}
+  </Button>
 {{/if}}
-  </button>
 </form>
 
-<div class="text-center mt-4">
+<div class='text-center mt-4'>
 {{#if hasI18n}}
-  <a href="/auth/login" class="link link-primary text-sm">{m.auth_register_to_login()}</a>
+  <a href={resolve('/auth/login', {})} class='link link-primary text-sm'>{m.auth_register_to_login()}</a>
 {{else}}
-  <a href="/auth/login" class="link link-primary text-sm">已有账号？立即登录</a>
+  <a href={resolve('/auth/login', {})} class='link link-primary text-sm'>已有账号？立即登录</a>
 {{/if}}
 </div>

package/templates/features/iam/routes-h5/auth/login/+page.svelte.hbs

@@ -1,18 +1,21 @@
 {{!-- H5 登录页面 --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * H5 登录页面
    */
+  import { resolve } from '$app/paths'
 {{#if hasI18n}}
   import * as m from '$lib/paraglide/messages'
 {{/if}}
+  import { Alert, Button, FormField, Input } from '@h-ai/ui'
 
   let username = $state('')
   let password = $state('')
   let error = $state('')
   let loading = $state(false)
 
-  async function handleLogin() {
+  async function handleLogin(event: SubmitEvent) {
+    event.preventDefault()
     error = ''
     loading = true
     try {
@@ -24,20 +27,23 @@
       const data = await res.json()
       if (data.success) {
         window.location.href = '/'
-      } else {
+      }
+      else {
 {{#if hasI18n}}
         error = data.error?.message || m.auth_login_failed()
 {{else}}
         error = data.error?.message || '登录失败'
 {{/if}}
       }
-    } catch {
+    }
+    catch {
 {{#if hasI18n}}
       error = m.auth_error_network()
 {{else}}
       error = '网络错误'
 {{/if}}
-    } finally {
+    }
+    finally {
       loading = false
     }
   }
@@ -51,48 +57,46 @@
 {{/if}}
 </svelte:head>
 
-<div class="p-4 pt-12">
+<div class='p-4 pt-12 space-y-4'>
 {{#if hasI18n}}
-  <h1 class="text-2xl font-bold text-center mb-8">{m.auth_login_title()}</h1>
+  <h1 class='text-2xl font-black tracking-tight text-center'>{m.auth_login_title()}</h1>
 {{else}}
-  <h1 class="text-2xl font-bold text-center mb-8">登录</h1>
+  <h1 class='text-2xl font-black tracking-tight text-center'>登录</h1>
 {{/if}}
 
   {#if error}
-    <div class="alert alert-error mb-4">
-      <span>{error}</span>
-    </div>
+    <Alert variant='error'>{error}</Alert>
   {/if}
 
-  <form onsubmit={(e) => { e.preventDefault(); handleLogin() }} class="space-y-4">
-    <div class="form-control">
-{{#if hasI18n}}
-      <input type="text" placeholder={m.auth_label_username()} class="input input-bordered w-full" bind:value={username} required />
-{{else}}
-      <input type="text" placeholder="用户名" class="input input-bordered w-full" bind:value={username} required />
-{{/if}}
-    </div>
-    <div class="form-control">
-{{#if hasI18n}}
-      <input type="password" placeholder={m.auth_label_password()} class="input input-bordered w-full" bind:value={password} required />
-{{else}}
-      <input type="password" placeholder="密码" class="input input-bordered w-full" bind:value={password} required />
-{{/if}}
-    </div>
-    <button type="submit" class="btn btn-primary w-full" disabled={loading}>
+  <form onsubmit={handleLogin} class='space-y-4'>
 {{#if hasI18n}}
+    <FormField label={m.auth_label_username()} required>
+      <Input id='username' type='text' bind:value={username} required />
+    </FormField>
+    <FormField label={m.auth_label_password()} required>
+      <Input id='password' type='password' bind:value={password} required />
+    </FormField>
+    <Button type='submit' variant='primary' loading={loading} class='w-full'>
       {loading ? m.auth_login_loading() : m.auth_login_submit()}
+    </Button>
 {{else}}
+    <FormField label='用户名' required>
+      <Input id='username' type='text' bind:value={username} required />
+    </FormField>
+    <FormField label='密码' required>
+      <Input id='password' type='password' bind:value={password} required />
+    </FormField>
+    <Button type='submit' variant='primary' loading={loading} class='w-full'>
       {loading ? '登录中...' : '登录'}
+    </Button>
 {{/if}}
-    </button>
   </form>
 
-  <div class="text-center mt-6">
+  <div class='text-center'>
 {{#if hasI18n}}
-    <a href="/auth/register" class="link link-primary text-sm">{m.auth_login_to_register()}</a>
+    <a href={resolve('/auth/register', {})} class='link link-primary text-sm'>{m.auth_login_to_register()}</a>
 {{else}}
-    <a href="/auth/register" class="link link-primary text-sm">没有账号？立即注册</a>
+    <a href={resolve('/auth/register', {})} class='link link-primary text-sm'>没有账号？立即注册</a>
 {{/if}}
   </div>
 </div>

package/templates/features/iam/routes-h5/auth/register/+page.svelte.hbs

@@ -1,11 +1,13 @@
 {{!-- H5 注册页面 --}}
-<script lang="ts">
+<script lang='ts'>
   /**
    * H5 注册页面
    */
+  import { resolve } from '$app/paths'
 {{#if hasI18n}}
   import * as m from '$lib/paraglide/messages'
 {{/if}}
+  import { Alert, Button, FormField, Input } from '@h-ai/ui'
 
   let username = $state('')
   let password = $state('')
@@ -13,7 +15,8 @@
   let error = $state('')
   let loading = $state(false)
 
-  async function handleRegister() {
+  async function handleRegister(event: SubmitEvent) {
+    event.preventDefault()
     error = ''
     if (password !== confirmPassword) {
 {{#if hasI18n}}
@@ -33,20 +36,23 @@
       const data = await res.json()
       if (data.success) {
         window.location.href = '/auth/login'
-      } else {
+      }
+      else {
 {{#if hasI18n}}
         error = data.error?.message || m.auth_register_failed()
 {{else}}
         error = data.error?.message || '注册失败'
 {{/if}}
       }
-    } catch {
+    }
+    catch {
 {{#if hasI18n}}
       error = m.auth_error_network()
 {{else}}
       error = '网络错误'
 {{/if}}
-    } finally {
+    }
+    finally {
       loading = false
     }
   }
@@ -60,55 +66,52 @@
 {{/if}}
 </svelte:head>
 
-<div class="p-4 pt-12">
+<div class='p-4 pt-12 space-y-4'>
 {{#if hasI18n}}
-  <h1 class="text-2xl font-bold text-center mb-8">{m.auth_register_title()}</h1>
+  <h1 class='text-2xl font-black tracking-tight text-center'>{m.auth_register_title()}</h1>
 {{else}}
-  <h1 class="text-2xl font-bold text-center mb-8">注册</h1>
+  <h1 class='text-2xl font-black tracking-tight text-center'>注册</h1>
 {{/if}}
 
   {#if error}
-    <div class="alert alert-error mb-4">
-      <span>{error}</span>
-    </div>
+    <Alert variant='error'>{error}</Alert>
   {/if}
 
-  <form onsubmit={(e) => { e.preventDefault(); handleRegister() }} class="space-y-4">
-    <div class="form-control">
-{{#if hasI18n}}
-      <input type="text" placeholder={m.auth_label_username()} class="input input-bordered w-full" bind:value={username} required />
-{{else}}
-      <input type="text" placeholder="用户名" class="input input-bordered w-full" bind:value={username} required />
-{{/if}}
-    </div>
-    <div class="form-control">
-{{#if hasI18n}}
-      <input type="password" placeholder={m.auth_label_password()} class="input input-bordered w-full" bind:value={password} required />
-{{else}}
-      <input type="password" placeholder="密码" class="input input-bordered w-full" bind:value={password} required />
-{{/if}}
-    </div>
-    <div class="form-control">
-{{#if hasI18n}}
-      <input type="password" placeholder={m.auth_label_confirm_password()} class="input input-bordered w-full" bind:value={confirmPassword} required />
-{{else}}
-      <input type="password" placeholder="确认密码" class="input input-bordered w-full" bind:value={confirmPassword} required />
-{{/if}}
-    </div>
-    <button type="submit" class="btn btn-primary w-full" disabled={loading}>
+  <form onsubmit={handleRegister} class='space-y-4'>
 {{#if hasI18n}}
+    <FormField label={m.auth_label_username()} required>
+      <Input id='username' type='text' bind:value={username} required />
+    </FormField>
+    <FormField label={m.auth_label_password()} required>
+      <Input id='password' type='password' bind:value={password} required />
+    </FormField>
+    <FormField label={m.auth_label_confirm_password()} required>
+      <Input id='confirmPassword' type='password' bind:value={confirmPassword} required />
+    </FormField>
+    <Button type='submit' variant='primary' loading={loading} class='w-full'>
       {loading ? m.auth_register_loading() : m.auth_register_submit()}
+    </Button>
 {{else}}
+    <FormField label='用户名' required>
+      <Input id='username' type='text' bind:value={username} required />
+    </FormField>
+    <FormField label='密码' required>
+      <Input id='password' type='password' bind:value={password} required />
+    </FormField>
+    <FormField label='确认密码' required>
+      <Input id='confirmPassword' type='password' bind:value={confirmPassword} required />
+    </FormField>
+    <Button type='submit' variant='primary' loading={loading} class='w-full'>
       {loading ? '注册中...' : '注册'}
+    </Button>
 {{/if}}
-    </button>
   </form>
 
-  <div class="text-center mt-6">
+  <div class='text-center'>
 {{#if hasI18n}}
-    <a href="/auth/login" class="link link-primary text-sm">{m.auth_register_to_login()}</a>
+    <a href={resolve('/auth/login', {})} class='link link-primary text-sm'>{m.auth_register_to_login()}</a>
 {{else}}
-    <a href="/auth/login" class="link link-primary text-sm">已有账号？立即登录</a>
+    <a href={resolve('/auth/login', {})} class='link link-primary text-sm'>已有账号？立即登录</a>
 {{/if}}
   </div>
 </div>

package/templates/skills/AGENTS.md

@@ -1,27 +1,70 @@
 # AGENTS.md
 
-> 通用 AI 编程助手指引。详细 Skill 文件位于 `.agents/skills/` 目录。
+> 通用 AI 编程助手入口。优先阅读 `README.md`、现有测试与 `.agents/skills/`；本文件同时作为 `hai add` / AI 支持回填时的 generic fallback。
+
+## 行为契约
+
+1. 每次响应第一行写：`规模: XS|S|M|L — <一句话意图>`。
+2. 任务规模 ≥ M 时，先回顾 `README.md`、相关测试、现有 AI 指导文件与对应 `.agents/skills/*/SKILL.md`。
+3. 在写第一行新代码前，用 1 行回答 Q1-Q7：复用对象、可扩展点、当前真实调用点、更简方案、知识泄漏、一致性、性能/安全对比。
+4. 任务规模 ≥ M 时，同步说明直接/间接影响：文件、接口/类型、导入、测试、文档、依赖方。
+5. 不能把未运行或失败的门禁写成“已通过”。
+
+## 必要性自检（M / L 任务必须输出）
+
+- Q1：仓库里是否已有同类能力可复用？
+- Q2：能否扩展现有文件/模块，而不是新建抽象或目录？
+- Q3：当前真实调用点是什么，不要为了“以后可能”而设计？
+- Q4：有没有少一层、少一个参数、少一个文件的更简单方案？
+- Q5：这次改动会不会让使用方必须了解新的内部细节？
+- Q6：是否与当前项目命名、目录、脚本和对外暴露形式一致？
+- Q7：是否已经比较过更高效或更安全的做法？
+
+## 影响分析（M / L 任务必须输出）
+
+- 直接影响：修改 / 新建 / 删除哪些文件；哪些脚本、类型、配置或路由会变。
+- 间接影响：哪些测试、README、i18n、示例、共享类型、依赖方需要同步更新。
 
 ## 项目概述
 
-本项目使用 hai-framework 构建，基于 SvelteKit 2 + Svelte 5 (Runes) + TailwindCSS 4 + DaisyUI 5 + TypeScript 5.7+。
+本项目由 hai-framework CLI 生成。单应用工程通常在 `src/` 下开发；多包工程会同时包含 `packages/*` 与 `apps/*`。实际结构以当前项目目录为准。
+
+## 通用硬约束
+
+- 先用全局检索确认是否已有实现、测试和文档；优先复用，避免为“未来可能”新增抽象。
+- 统一模式：`module.init(config) -> use -> module.close()`；公共 `@h-ai/*` API 返回 `HaiResult<T>` 或 `Promise<HaiResult<T>>`，业务错误不要直接 `throw`。
+- 禁止 `any`、无说明的危险类型断言、`console.log`、硬编码密钥。
+- 用户可见文本必须走 i18n；如果项目启用了 `messages/zh-CN.json` 与 `messages/en-US.json`，修改文案时必须同步更新。
+- 代码注释中文，日志消息英文。
+- 如项目使用 SvelteKit，`+server.ts` 只能导出 HTTP handler 与 SvelteKit 允许的配置项；辅助函数放到 `src/lib/**`。
+
+## 工作流程
+
+1. 先搜索现有实现、引用点、测试和 README。
+2. 小步修改，优先保持目录结构、公开 API 和脚本稳定。
+3. 改动公共类型、配置、模板或共享逻辑时，同步更新所有调用方与文档。
+4. 每次改动后按影响范围运行质量门禁并记录结果。
+
+## 质量门禁
 
-## 核心规范
+```bash
+pnpm typecheck
+pnpm lint
+pnpm build
+pnpm test
+pnpm test:e2e
+```
 
-- 统一模式：`module.init(config) → use → module.close()`，所有操作返回 `HaiResult<T>`
-- **TDD 驱动开发**：先写测试（Red）→ 确认失败 → 再实现（Green）→ 确认通过 → 重构（Refactor）
-- 禁止 `any`（使用 `unknown` + 缩窄），禁止 `console.log`（使用 `core.logger`）
-- 用户可见文本走 i18n，代码注释中文，日志英文
-- HaiResult 错误直接透传，不重新包装
-- 框架模块公共 API 不抛异常，统一返回 `HaiResult<T>`；不要用 `try/catch` 处理模块返回的错误
-- 质量门禁：`pnpm typecheck && pnpm lint && pnpm test && pnpm --filter <app> test:e2e`
+## 完成条件
 
-## Skills 参考
+- typecheck / lint / build / test / test:e2e 状态明确；失败必须先修复或明确说明原因。
+- README、i18n、测试、代码注释与实现保持一致。
+- 最终回复说明执行过的门禁、已同步的文档 / 依赖方，以及未完成项。
 
-所有详细指南位于 `.agents/skills/` 目录，按需阅读：
+## Skills 路由
 
-- **入口**：`hai-build/SKILL.md` — 项目架构总览与 Skill 导航
-- **框架模块**：`hai-core/`、`hai-kit/`、`hai-reldb/`、`hai-iam/`、`hai-crypto/`、`hai-cache/`、`hai-storage/`、`hai-ai/`
-- **UI 组件**：`hai-ui/SKILL.md`
-- **TDD 开发流程**：`hai-app-tests/`（TDD 测试先行）、`hai-app-create/`（TDD 实现）、`hai-app-review/`（TDD 重构审查）
-- **仓库工程流程**：`hai-ci/`（CI/CD 与质量门禁）、`hai-pr-review/`（PR / Issue 交付审查与 AI Review）、`hai-framework-sync/`（两仓同步）
+- `hai-build/SKILL.md`：架构、构建和质量门禁。
+- `hai-app-create/SKILL.md`：应用骨架、路由、页面与 API 模板。
+- `hai-app-review/SKILL.md`：应用代码审查。
+- `hai-app-tests/SKILL.md`：Vitest / Playwright 测试策略。
+- 具体模块按需读取对应 `hai-*` Skill。