@mison/ag-kit-cn 2.0.1

package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md

@@ -0,0 +1,88 @@
+---
+name: cli-tool
+description: Node.js CLI tool template principles（CLI 工具模板原则）。Commander.js、interactive prompts（交互式提示）。
+---
+
+# CLI Tool Template（CLI 工具模板）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） |
+| --- | --- |
+| Runtime（运行时） | Node.js 20+ |
+| Language（语言） | TypeScript |
+| CLI Framework（CLI 框架） | Commander.js |
+| Prompts（提示） | Inquirer.js |
+| Output（输出） | chalk + ora（着色/加载） |
+| Config（配置） | cosmiconfig |
+
+---
+
+## Directory Structure（目录结构）
+
+```
+project-name/
+├── src/
+│   ├── index.ts         # Entry point（入口）
+│   ├── cli.ts           # CLI setup（CLI 设置）
+│   ├── commands/        # Command handlers（命令处理）
+│   ├── lib/
+│   │   ├── config.ts    # Config loader（配置加载）
+│   │   └── logger.ts    # Styled output（样式化输出）
+│   └── types/
+├── bin/
+│   └── cli.js           # Executable（可执行文件）
+└── package.json
+```
+
+---
+
+## CLI Design Principles（CLI 设计原则）
+
+| Principle（原则） | Description（说明） |
+| --- | --- |
+| Subcommands（子命令） | Group related actions（分组相关操作） |
+| Options（选项） | Flags with defaults（带默认值的标志） |
+| Interactive（交互） | Prompts when needed（需要时提示） |
+| Non-interactive（非交互） | Support `--yes` flags（支持 `--yes` 标志） |
+
+---
+
+## Key Components（关键组件）
+
+| Component（组件） | Purpose（用途） |
+| --- | --- |
+| Commander | Command parsing（命令解析） |
+| Inquirer | Interactive prompts（交互提示） |
+| Chalk | Colored output（彩色输出） |
+| Ora | Spinners/loading（旋转指示/加载） |
+| Cosmiconfig | Config file discovery（配置文件发现） |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. Create project directory（创建项目目录）
+2. `npm init -y`
+3. Install deps（安装依赖）：`npm install commander @inquirer/prompts chalk ora cosmiconfig`
+4. Configure bin in package.json（配置 bin）
+5. `npm link` for local testing（本地测试）
+
+---
+
+## Publishing（发布）
+
+```bash
+npm login
+npm publish
+```
+
+---
+
+## Best Practices（最佳实践）
+
+- Provide helpful error messages（清晰错误信息）
+- Support both interactive and non-interactive modes（同时支持交互与非交互）
+- Use consistent output styling（一致的输出样式）
+- Validate inputs with Zod（使用 Zod 验证输入）
+- Exit with proper codes（0 success, 1 error）

package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md

@@ -0,0 +1,88 @@
+---
+name: electron-desktop
+description: Electron desktop app template principles（桌面应用模板原则）。Cross-platform（跨平台）、React、TypeScript。
+---
+
+# Electron Desktop App Template（桌面应用模板）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） |
+| --- | --- |
+| Framework（框架） | Electron 28+ |
+| UI | React 18 |
+| Language（语言） | TypeScript |
+| Styling（样式） | Tailwind CSS |
+| Bundler（打包器） | Vite + electron-builder |
+| IPC（进程间通信） | Type-safe communication（类型安全通信） |
+
+---
+
+## Directory Structure（目录结构）
+
+```
+project-name/
+├── electron/
+│   ├── main.ts          # Main process（主进程）
+│   ├── preload.ts       # Preload script（预加载脚本）
+│   └── ipc/             # IPC handlers（IPC 处理）
+├── src/
+│   ├── App.tsx
+│   ├── components/
+│   │   ├── TitleBar.tsx # Custom title bar（自定义标题栏）
+│   │   └── ...
+│   └── hooks/
+├── public/
+└── package.json
+```
+
+---
+
+## Process Model（进程模型）
+
+| Process（进程） | Role（角色） |
+| --- | --- |
+| Main（主进程） | Node.js, system access（系统访问） |
+| Renderer（渲染进程） | Chromium, React UI（界面） |
+| Preload（预加载） | Bridge（桥接）, context isolation（上下文隔离） |
+
+---
+
+## Key Concepts（关键概念）
+
+| Concept（概念） | Purpose（用途） |
+| --- | --- |
+| contextBridge | Safe API exposure（安全 API 暴露） |
+| ipcMain/ipcRenderer | Process communication（进程通信） |
+| nodeIntegration: false | Security（安全） |
+| contextIsolation: true | Security（安全） |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. `npm create vite {{name}} -- --template react-ts`
+2. Install（安装）：`npm install -D electron electron-builder vite-plugin-electron`
+3. Create `electron/` directory（创建目录）
+4. Configure main process（配置主进程）
+5. `npm run electron:dev`
+
+---
+
+## Build Targets（构建目标）
+
+| Platform（平台） | Output（输出） |
+| --- | --- |
+| Windows | NSIS, Portable |
+| macOS | DMG, ZIP |
+| Linux | AppImage, DEB |
+
+---
+
+## Best Practices（最佳实践）
+
+- Use preload script for main/renderer bridge（主/渲染进程桥接）
+- Type-safe IPC with typed handlers（类型安全 IPC）
+- Custom title bar for native feel（原生感）
+- Handle window state（maximize/minimize）
+- Auto-updates with electron-updater（自动更新）

package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md

@@ -0,0 +1,83 @@
+---
+name: express-api
+description: Express.js REST API 模板原则。TypeScript（类型系统）、Prisma（ORM）、JWT（身份验证）。
+---
+
+# Express.js API Template（API 模板）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） |
+| --- | --- |
+| Runtime（运行时） | Node.js 20+ |
+| Framework（框架） | Express.js |
+| Language（语言） | TypeScript |
+| Database（数据库） | PostgreSQL + Prisma |
+| Validation（校验） | Zod |
+| Auth（认证） | JWT + bcrypt |
+
+---
+
+## Directory Structure（目录结构）
+
+```
+project-name/
+├── prisma/
+│   └── schema.prisma
+├── src/
+│   ├── app.ts           # Express setup（Express 启动入口）
+│   ├── config/          # Environment（环境配置）
+│   ├── routes/          # Route handlers（路由处理）
+│   ├── controllers/     # Business logic（业务逻辑）
+│   ├── services/        # Data access（数据访问）
+│   ├── middleware/
+│   │   ├── auth.ts      # JWT verify（JWT 鉴权）
+│   │   ├── error.ts     # Error handler（错误处理）
+│   │   └── validate.ts  # Zod validation（Zod 校验）
+│   ├── schemas/         # Zod schemas（Zod 模式）
+│   └── utils/
+└── package.json
+```
+
+---
+
+## Middleware Stack（中间件栈）
+
+| Order（顺序） | Middleware（中间件） |
+| --- | --- |
+| 1 | helmet（安全） |
+| 2 | cors |
+| 3 | morgan（日志） |
+| 4 | body parsing（请求体解析） |
+| 5 | routes（路由） |
+| 6 | error handler（错误处理） |
+
+---
+
+## API Response Format（API 响应格式）
+
+| Type（类型） | Structure（结构） |
+| --- | --- |
+| 成功 | `{ success: true, data: {...} }` |
+| 错误 | `{ error: "message", details: [...] }` |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. 创建项目目录
+2. `npm init -y`
+3. 安装依赖：`npm install express prisma zod bcrypt jsonwebtoken`
+4. 配置 Prisma
+5. `npm run db:push`
+6. `npm run dev`
+
+---
+
+## Best Practices（最佳实践）
+
+- 分层架构（routes → controllers → services）
+- 使用 Zod（校验）验证所有输入
+- 集中式错误处理
+- 基于环境的配置
+- 使用 Prisma（ORM）进行类型安全的数据库访问

package/.agent/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/.agent/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/.agent/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/.agent/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
+   ```