@mison/ling 1.0.0

package/.agents/skills/app-builder/templates/flutter-app/TEMPLATE.md

@@ -0,0 +1,90 @@
+---
+name: flutter-app
+description: Flutter mobile app template（移动应用模板）原则。Riverpod（状态管理）、Go Router（路由）、Clean Architecture（整洁架构）。
+---
+
+# Flutter App Template（应用模板）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） |
+| --- | --- |
+| Framework（框架） | Flutter 3.x |
+| Language（语言） | Dart 3.x |
+| State（状态） | Riverpod 2.0 |
+| Navigation（导航） | Go Router |
+| HTTP | Dio |
+| Storage（存储） | Hive |
+
+---
+
+## Directory Structure（目录结构）
+
+```
+project_name/
++-- lib/
+|   +-- main.dart
+|   +-- app.dart
+|   +-- core/
+|   |   +-- constants/
+|   |   +-- theme/
+|   |   +-- router/
+|   |   +-- utils/
+|   +-- features/
+|   |   +-- auth/
+|   |   |   +-- data/
+|   |   |   +-- domain/
+|   |   |   +-- presentation/
+|   |   +-- home/
+|   +-- shared/
+|   |   +-- widgets/
+|   |   +-- providers/
+|   +-- services/
+|       +-- api/
+|       +-- storage/
++-- test/
++-- pubspec.yaml
+```
+
+---
+
+## Architecture Layers（架构层）
+
+| Layer（层） | Contents（内容） |
+| --- | --- |
+| Presentation（表现层） | Screens（页面）、Widgets（组件）、Providers（提供器） |
+| Domain（领域层） | Entities（实体）、Use Cases（用例） |
+| Data（数据层） | Repositories（仓储）、Models（模型） |
+
+---
+
+## Key Packages（关键包）
+
+| Package（包） | Purpose（用途） |
+| --- | --- |
+| flutter_riverpod | 状态管理 |
+| riverpod_annotation | 代码生成 |
+| go_router | 导航 |
+| dio | HTTP 客户端 |
+| freezed | 不可变模型 |
+| hive | 本地存储 |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. `flutter create {{name}} --org com.{{bundle}}`
+2. 更新 `pubspec.yaml`
+3. `flutter pub get`
+4. 运行代码生成：`dart run build_runner build`
+5. `flutter run`
+
+---
+
+## Best Practices（最佳实践）
+
+- Feature-first（功能优先）文件夹结构
+- Riverpod（状态管理）用于状态管理，React Query pattern（服务端状态模式）
+- Freezed（不可变模型）用于不可变数据类
+- Go Router（路由）用于声明式导航
+- Material 3（设计规范）主题

package/.agents/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md

@@ -0,0 +1,90 @@
+---
+name: monorepo-turborepo
+description: Turborepo monorepo template principles（模板原则）。pnpm workspaces（工作区）、shared packages（共享包）。
+---
+
+# Turborepo Monorepo Template（模板）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） |
+| --- | --- |
+| Build System（构建系统） | Turborepo |
+| Package Manager（包管理器） | pnpm |
+| Apps（应用） | Next.js、Express |
+| Packages（包） | Shared UI, Config, Types（共享 UI/配置/类型） |
+| Language（语言） | TypeScript |
+
+---
+
+## Directory Structure（目录结构）
+
+```
+project-name/
++-- apps/
+|   +-- web/             # Next.js app（应用）
+|   +-- api/             # Express API
+|   +-- docs/            # Documentation（文档）
++-- packages/
+|   +-- ui/              # Shared components（共享组件）
+|   +-- config/          # ESLint, TS, Tailwind
+|   +-- types/           # Shared types（共享类型）
+|   +-- utils/           # Shared utilities（共享工具）
++-- turbo.json
++-- pnpm-workspace.yaml
++-- package.json
+```
+
+---
+
+## Key Concepts（关键概念）
+
+| Concept（概念） | Description（说明） |
+| --- | --- |
+| Workspaces（工作区） | pnpm-workspace.yaml |
+| Pipeline（管道） | turbo.json task graph（任务图） |
+| Caching（缓存） | Remote/local task caching（远程/本地任务缓存） |
+| Dependencies（依赖） | `workspace:*` protocol（协议） |
+
+---
+
+## Turbo Pipeline（任务管道）
+
+| Task（任务） | Depends On（依赖） |
+| --- | --- |
+| build | ^build (dependencies first)（依赖优先） |
+| dev | cache: false, persistent（不缓存，常驻） |
+| lint | ^build |
+| test | ^build |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. Create root directory（创建根目录）
+2. `pnpm init`
+3. Create pnpm-workspace.yaml（创建）
+4. Create turbo.json（创建）
+5. Add apps and packages（添加应用与包）
+6. `pnpm install`
+7. `pnpm dev`
+
+---
+
+## Common Commands（常用命令）
+
+| Command（命令） | Description（说明） |
+| --- | --- |
+| `pnpm dev` | Run all apps（运行全部应用） |
+| `pnpm build` | Build all（构建全部） |
+| `pnpm --filter @name/web dev` | Run specific app（运行指定应用） |
+| `pnpm --filter @name/web add axios` | Add dep to app（为应用添加依赖） |
+
+---
+
+## Best Practices（最佳实践）
+
+- Shared configs in packages/config（共享配置）
+- Shared types in packages/types（共享类型）
+- Internal packages with `workspace:*`
+- Use Turbo remote caching for CI（CI 远程缓存）

package/.agents/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md

@@ -0,0 +1,122 @@
+---
+name: nextjs-fullstack
+description: Next.js Full-Stack template（全栈模板）原则。App Router、Prisma、Tailwind v4。
+---
+
+# Next.js Full-Stack Template（全栈模板，2026 版）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） | Version / Notes（版本/说明） |
+| --- | --- | --- |
+| Framework（框架） | Next.js | v16+（App Router、Turbopack） |
+| Language（语言） | TypeScript | v5+（Strict Mode，严格模式） |
+| Database（数据库） | PostgreSQL | Prisma ORM（Serverless-friendly，适配 Serverless） |
+| Styling（样式） | Tailwind CSS | v4.0（零配置，CSS-first） |
+| Auth（认证） | Clerk / Better Auth | 中间件保护路由 |
+| UI Logic（UI 逻辑） | React 19 | Server Actions、useActionState |
+| Validation（验证） | Zod | Schema 校验（API & Forms） |
+
+---
+
+## Directory Structure（目录结构）
+
+```
+project-name/
++-- prisma/
+|   +-- schema.prisma       # Database schema（数据库结构）
++-- src/
+|   +-- app/
+|   |   +-- (auth)/         # 登录/注册路由组
+|   |   +-- (dashboard)/    # 受保护路由
+|   |   +-- api/            # Route Handlers（仅用于 Webhooks/外部集成）
+|   |   +-- layout.tsx      # Root Layout（Metadata, Providers）
+|   |   +-- page.tsx        # Landing Page（落地页）
+|   |   +-- globals.css     # Tailwind v4 配置（@theme 在此）
+|   +-- components/
+|   |   +-- ui/             # 可复用 UI（Button, Input）
+|   |   +-- forms/          # Client forms（useActionState）
+|   +-- lib/
+|   |   +-- db.ts           # Prisma singleton client（单例客户端）
+|   |   +-- utils.ts        # Helper functions（辅助函数）
+|   |   +-- dal.ts          # Data Access Layer（仅服务端）
+|   +-- actions/            # Server Actions（变更）
+|   +-- types/              # Global TS Types（类型）
++-- public/
++-- next.config.ts          # TypeScript Config（配置）
++-- package.json
+```
+
+---
+
+## Key Concepts（更新）
+
+| Concept（概念） | Description（说明） |
+| --- | --- |
+| Server Components（服务端组件） | 在服务端渲染（默认）。无需 API 即可直接访问 Prisma。 |
+| Server Actions（服务端动作） | 处理表单变更，替代传统 API Routes。用于 `action={}`。 |
+| React 19 Hooks（钩子） | 表单状态管理：useActionState、useFormStatus、useOptimistic。 |
+| Data Access Layer（数据访问层） | 数据安全。分离数据库逻辑（DTOs）以安全复用。 |
+| Tailwind v4 | 样式引擎。无需 tailwind.config.js，在 CSS 中直接配置。 |
+
+---
+
+## Environment Variables（环境变量）
+
+| Variable（变量） | Purpose（用途） |
+| --- | --- |
+| DATABASE_URL | PostgreSQL connection string（Prisma） |
+| NEXT_PUBLIC_APP_URL | Public application URL（公共应用 URL） |
+| NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY | Auth（使用 Clerk 时） |
+| CLERK_SECRET_KEY | Auth secret（仅服务端） |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. Initialize Project（初始化项目）：
+   ```bash
+   npx create-next-app@latest my-app --typescript --tailwind --eslint
+   # 选择 Yes（App Router）
+   # 选择 No（src 目录）（可选，本模板使用 src）
+   ```
+
+2. Install DB & Validation（安装数据库与校验）：
+   ```bash
+   npm install prisma @prisma/client zod
+   npm install -D ts-node # 用于运行 seed 脚本
+   ```
+
+3. Configure Tailwind v4（如缺失）：
+   确保 `src/app/globals.css` 使用新的导入语法，而不是配置文件：
+   ```css
+   @import "tailwindcss";
+
+   @theme {
+     --color-primary: oklch(0.5 0.2 240);
+     --font-sans: "Inter", sans-serif;
+   }
+   ```
+
+4. Initialize Database（初始化数据库）：
+   ```bash
+   npx prisma init
+   # 更新 schema.prisma
+   npm run db:push
+   ```
+
+5. 启动开发服务器：
+   ```bash
+   npm run dev --turbo
+   # --turbo 启用更快的 Turbopack
+   ```
+
+---
+
+## 最佳实践（2026 标准）
+
+- **获取数据（Fetch Data）**：在 Server Components 中直接调用 Prisma（async/await），不要用 useEffect 获取初始数据。
+- **变更（Mutations）**：使用 Server Actions + React 19 的 `useActionState` 处理加载与错误状态，避免手动 useState。
+- **类型安全（Type Safety）**：在 Server Actions（输入验证）与客户端表单之间共享 Zod schema。
+- **安全（Security）**：将数据传给 Prisma 前必须用 Zod 验证输入。
+- **样式（Styling）**：在 Tailwind v4 中使用原生 CSS 变量，便于动态主题。

package/.agents/skills/app-builder/templates/nextjs-saas/TEMPLATE.md

@@ -0,0 +1,122 @@
+---
+name: nextjs-saas
+description: Next.js SaaS template（SaaS 模板）原则（2026 Standards，2026 标准）。React 19、Server Actions（服务端动作）、Auth.js v6。
+---
+
+# Next.js SaaS Template（2026 更新）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） | Version / Notes（版本/说明） |
+| --- | --- | --- |
+| Framework（框架） | Next.js | v16+（App Router、React Compiler（编译器）） |
+| Runtime（运行时） | Node.js | v24（Krypton LTS） |
+| Auth（认证） | Auth.js | v6（原名 NextAuth） |
+| Payments（支付） | Stripe API | Latest（最新） |
+| Database（数据库） | PostgreSQL | Prisma v6（Serverless Driver，无服务器驱动） |
+| Email（邮件） | Resend | React Email（邮件模板） |
+| UI（界面） | Tailwind CSS | v4（Oxide Engine、无配置文件） |
+
+---
+
+## Directory Structure（目录结构）
+
+```
+project-name/
++-- prisma/
+|   +-- schema.prisma    # Database Schema（数据库 Schema）
++-- src/
+|   +-- actions/         # NEW: Server Actions（用于数据变更，替代 API Routes（API 路由））
+|   |   +-- auth-actions.ts
+|   |   +-- billing-actions.ts
+|   |   +-- user-actions.ts
+|   +-- app/
+|   |   +-- (auth)/      # Route Group（路由组）：登录、注册
+|   |   +-- (dashboard)/ # Route Group（路由组）：受保护路由（应用布局）
+|   |   +-- (marketing)/ # Route Group（路由组）：落地页、价格（营销布局）
+|   |   +-- api/         # 仅用于 Webhooks（回调）或 Edge cases（边缘场景）
+|   |       +-- webhooks/stripe/
+|   +-- components/
+|   |   +-- emails/      # React Email templates（邮件模板）
+|   |   +-- forms/       # 使用 useActionState 的 Client components（客户端组件）（React 19）
+|   |   +-- ui/          # Shadcn UI（组件库）
+|   +-- lib/
+|   |   +-- auth.ts      # Auth.js v6 config（配置）
+|   |   +-- db.ts        # Prisma Singleton（单例）
+|   |   +-- stripe.ts    # Stripe Singleton（单例）
+|   +-- styles/
+|       +-- globals.css  # Tailwind v4 导入（仅 CSS）
++-- package.json
+```
+
+---
+
+## SaaS Features（SaaS 功能）
+
+| Feature（功能） | Implementation（实现） |
+| --- | --- |
+| Auth（认证） | Auth.js v6 + Passkeys（通行密钥） + OAuth（授权） |
+| Data Mutation（数据变更） | Server Actions（不使用 API routes（API 路由）） |
+| Subscriptions（订阅） | Stripe Checkout & Customer Portal（结算与客户门户） |
+| Webhooks（回调） | 异步处理 Stripe 事件 |
+| Email（邮件） | 通过 Resend 发送事务邮件 |
+| Validation（校验） | Zod（服务端校验） |
+
+---
+
+## Database Schema（数据库结构）
+
+| Model（模型） | Fields（字段，关键字段） |
+| --- | --- |
+| User | id, email, stripeCustomerId, subscriptionId, plan |
+| Account | OAuth provider data（OAuth 提供方数据，Google, GitHub...） |
+| Session | 用户会话（Database strategy，数据库策略） |
+
+---
+
+## Environment Variables（环境变量）
+
+| Variable（变量） | Purpose（用途） |
+| --- | --- |
+| DATABASE_URL | Prisma 连接字符串（Postgres） |
+| AUTH_SECRET | 替代 NEXTAUTH_SECRET（Auth.js v6） |
+| STRIPE_SECRET_KEY | Payments（支付，服务端） |
+| STRIPE_WEBHOOK_SECRET | Webhook 校验 |
+| RESEND_API_KEY | 邮件发送 |
+| NEXT_PUBLIC_APP_URL | 应用规范 URL |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. 初始化项目（Node 24）：
+   ```bash
+   npx create-next-app@latest {{name}} --typescript --eslint
+   ```
+
+2. 安装核心库：
+   ```bash
+   npm install next-auth@beta stripe resend @prisma/client
+   ```
+
+3. 安装 Tailwind v4（添加到 globals.css）：
+   ```css
+   @import "tailwindcss";
+   ```
+
+4. 配置环境变量（.env.local）
+
+5. 同步数据库：
+   ```bash
+   npx prisma db push
+   ```
+
+6. 运行本地 Webhook：
+   ```bash
+   npm run stripe:listen
+   ```
+
+7. 运行项目：
+   ```bash
+   npm run dev
+   ```

package/.agents/skills/app-builder/templates/nextjs-static/TEMPLATE.md

@@ -0,0 +1,169 @@
+---
+name: nextjs-static
+description: Modern template for Next.js 16, React 19 & Tailwind v4（现代模板）。Optimized for Landing pages（落地页） and Portfolios（作品集）。
+---
+
+# Next.js Static Site Template（Modern Edition，现代版）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） | Notes（说明） |
+| --- | --- | --- |
+| Framework（框架） | Next.js 16+ | App Router（应用路由）、Turbopack、Static Exports（静态导出） |
+| Core（核心） | React 19 | Server Components（服务端组件）、New Hooks（新 Hooks）、Compiler（编译器） |
+| Language（语言） | TypeScript | Strict Mode（严格模式） |
+| Styling（样式） | Tailwind CSS v4 | CSS-first configuration（无 js 配置）、Oxide Engine |
+| Animations（动画） | Framer Motion | 布局动画与手势 |
+| Icons（图标） | Lucide React | 轻量 SVG 图标 |
+| SEO | Metadata API | Native Next.js API（替代 next-seo） |
+
+---
+
+## Directory Structure（目录结构）
+
+Streamlined structure thanks to Tailwind v4（主题配置位于 CSS 内）。
+
+```
+project-name/
++-- src/
+|   +-- app/
+|   |   +-- layout.tsx    # Contains root SEO Metadata（根级 SEO 元数据）
+|   |   +-- page.tsx      # Landing Page（落地页）
+|   |   +-- globals.css   # Import Tailwind v4 & @theme config（导入 Tailwind v4 与 @theme 配置）
+|   |   +-- not-found.tsx # Custom 404 page（自定义 404 页面）
+|   |   +-- (routes)/     # Route groups（路由组，about, contact...）
+|   +-- components/
+|   |   +-- layout/       # Header, Footer（页头、页脚）
+|   |   +-- sections/     # Hero, Features, Pricing, CTA（主视觉、功能亮点、价格方案、CTA）
+|   |   +-- ui/           # Atomic components（Button, Card）
+|   +-- lib/
+|       +-- utils.ts      # Helper functions（cn, formatters）
++-- content/              # Markdown/MDX content（内容）
++-- public/               # Static assets（images, fonts）
++-- next.config.ts        # Next.js Config（TypeScript）
++-- package.json
+```
+
+---
+
+## Static Export Config（静态导出配置）
+
+Using `next.config.ts` instead of `.js` for better type safety（更好的类型安全）。
+
+```typescript
+// next.config.ts
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  output: 'export',        // Required for Static Hosting（S3、GitHub Pages）
+  images: { 
+    unoptimized: true      // Required if not using Node.js server image optimization（不使用 Node.js 服务器图像优化时必需）
+  },
+  trailingSlash: true,     // Recommended for SEO and fixing 404s on some hosts（推荐用于 SEO 并修复某些主机 404）
+  reactStrictMode: true,
+};
+
+export default nextConfig;
+```
+
+---
+
+## SEO Implementation（Metadata API）
+
+Deprecated next-seo. Configure directly in layout.tsx or page.tsx（直接在 layout.tsx 或 page.tsx 中配置）。
+
+```typescript
+// src/app/layout.tsx
+import type { Metadata } from 'next';
+
+export const metadata: Metadata = {
+  title: {
+    template: '%s | Product Name',
+    default: 'Home - Product Name',
+  },
+  description: 'SEO optimized description for the landing page.',
+  openGraph: {
+    type: 'website',
+    locale: 'en_US',
+    url: 'https://mysite.com',
+    siteName: 'My Brand',
+  },
+};
+```
+
+---
+
+## Landing Page Sections（落地页模块）
+
+| Section（模块） | Purpose（作用） | Suggested Component（建议组件） |
+| --- | --- | --- |
+| Hero（主视觉） | First impression, H1 & Main CTA（第一印象、主 CTA） | `<HeroSection />` |
+| Features（功能亮点） | Product benefits（Grid/Bento 布局） | `<FeaturesGrid />` |
+| Social Proof（社会证明） | Partner logos, User numbers（合作伙伴 Logo、用户数量） | `<LogoCloud />` |
+| Testimonials（客户评价） | Customer reviews（用户评价） | `<TestimonialCarousel />` |
+| Pricing（价格方案） | Service plans（服务计划） | `<PricingCards />` |
+| FAQ（常见问题） | Questions & Answers（利于 SEO） | `<Accordion />` |
+| CTA（转化模块） | Final conversion（最终转化） | `<CallToAction />` |
+
+---
+
+## Animation Patterns（Framer Motion）
+
+| Pattern（模式） | Usage（用途） | Implementation（实现） |
+| --- | --- | --- |
+| Fade Up（淡入上移） | Headlines, paragraphs（标题、段落） | `initial={{ opacity: 0, y: 20 }} animate={{ opacity: 1, y: 0 }}` |
+| Stagger（交错入场） | Lists of Features/Cards（功能/卡片列表） | Use variants with `staggerChildren`（使用 variants） |
+| Parallax（视差） | Background images or floating elements（背景图像/浮动元素） | `useScroll` & `useTransform` |
+| Micro-interactions（微交互） | Hover buttons, click effects（悬停/点击效果） | `whileHover={{ scale: 1.05 }} whileTap={{ scale: 0.95 }}` |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. Initialize Project（初始化项目）：
+   ```bash
+   npx create-next-app@latest my-site --typescript --tailwind --eslint
+   # Select "Yes" for App Router（选择 Yes 以启用 App Router）
+   # Select "No" for default import alias（选择 No 以保持默认导入别名）
+   ```
+
+2. Install Auxiliary Libraries（安装辅助库）：
+   ```bash
+   npm install framer-motion lucide-react clsx tailwind-merge
+   # clsx and tailwind-merge help handle dynamic classes（更好处理动态 class）
+   ```
+
+3. Configure Tailwind v4（位于 `src/app/globals.css`）：
+   ```css
+   @import "tailwindcss";
+
+   @theme {
+     --color-primary: #3b82f6;
+     --font-sans: 'Inter', sans-serif;
+   }
+   ```
+
+4. Development（开发运行）：
+   ```bash
+   npm run dev --turbopack
+   ```
+
+---
+
+## Deployment（部署）
+
+| Platform（平台） | Method（方式） | Important Notes（重要说明） |
+| --- | --- | --- |
+| Vercel | Git Push（Git 推送） | Auto-detects Next.js. Best for performance（性能最佳） |
+| GitHub Pages | GitHub Actions（工作流） | If not using a custom domain, set `basePath` in `next.config.ts` |
+| AWS S3 / CloudFront | Upload out folder（上传 out 文件夹） | Ensure Error Document is configured to `404.html` |
+| Netlify | Git Push（Git 推送） | Set build command to `npm run build` |
+
+---
+
+## Best Practices (Modern)（现代最佳实践）
+
+- **React Server Components (RSC)**: Default all components to Server Components（服务端组件）. Only add `'use client'` when you need state (`useState`) or event listeners (`onClick`).
+- **Image Optimization（图片优化）**: Use the `<Image />` component but remember `unoptimized: true` for static export or use an external image CDN（Cloudinary/Imgix）.
+- **Font Optimization（字体优化）**: Use `next/font`（Google Fonts） to automatically host fonts and prevent layout shift.
+- **Responsive（响应式）**: Mobile-first design using Tailwind prefixes like `sm:`, `md:`, `lg:`.