@mison/ling 1.0.0

package/.agents/skills/app-builder/scaffolding.md

@@ -0,0 +1,118 @@
+# 项目脚手架
+
+> 新项目的目录结构与核心文件。
+
+---
+
+## Next.js 全栈结构（2025 优化版）
+
+```
+project-name/
++-- src/
+|   +-- app/                        # 路由层（仅路由，薄层）
+|   |   +-- layout.tsx
+|   |   +-- page.tsx
+|   |   +-- globals.css
+|   |   +-- (auth)/                 # 路由分组 - 认证页面
+|   |   |   +-- login/page.tsx
+|   |   |   +-- register/page.tsx
+|   |   +-- (dashboard)/            # 路由分组 - 仪表盘布局
+|   |   |   +-- layout.tsx
+|   |   |   +-- page.tsx
+|   |   +-- api/
+|   |       +-- [resource]/route.ts
+|   |
+|   +-- features/                   # Feature-based（功能模块）
+|   |   +-- auth/
+|   |   |   +-- components/
+|   |   |   +-- hooks/
+|   |   |   +-- actions.ts          # Server Actions（服务端动作）
+|   |   |   +-- queries.ts          # Data fetching（数据获取）
+|   |   |   +-- types.ts
+|   |   +-- products/
+|   |   |   +-- components/
+|   |   |   +-- actions.ts
+|   |   |   +-- queries.ts
+|   |   +-- cart/
+|   |       +-- ...
+|   |
+|   +-- shared/                     # Shared utilities（共享工具）
+|   |   +-- components/ui/          # 可复用 UI（用户界面）组件
+|   |   +-- lib/                    # 工具/辅助
+|   |   +-- hooks/                  # hooks（钩子）
+|   |
+|   +-- server/                     # 仅服务端代码
+|       +-- db/                     # Prisma（ORM）数据库客户端
+|       +-- auth/                   # 认证配置
+|       +-- services/               # 外部 API（应用程序接口）集成
+|
++-- prisma/
+|   +-- schema.prisma
+|   +-- migrations/
+|   +-- seed.ts
+|
++-- public/
++-- .env.example
++-- .env.local
++-- package.json
++-- tailwind.config.ts
++-- tsconfig.json
++-- README.md
+```
+
+---
+
+## 结构原则
+
+| 原则 | 实现方式 |
+| --- | --- |
+| **Feature isolation（功能隔离）** | 每个功能在 `features/` 下拥有自己的组件、hooks（钩子）、actions |
+| **Server/Client separation（服务端/客户端分离）** | 仅服务端代码放在 `server/`，防止客户端误导入 |
+| **Thin routes（薄路由层）** | `app/` 只负责路由，逻辑放在 `features/` |
+| **Route groups（路由分组）** | 使用 `(groupName)/` 共享布局且不影响 URL |
+| **Shared code（共享代码）** | `shared/` 存放真正可复用的 UI（用户界面）与工具 |
+
+---
+
+## 核心文件
+
+| 文件 | 用途 |
+| --- | --- |
+| `package.json` | 依赖管理 |
+| `tsconfig.json` | TypeScript（类型脚本语言）与路径别名（`@/features/*`） |
+| `tailwind.config.ts` | Tailwind（CSS 框架）配置 |
+| `.env.example` | 环境变量模板 |
+| `README.md` | 项目文档 |
+| `.gitignore` | Git 忽略规则 |
+| `prisma/schema.prisma` | Database schema（数据库结构） |
+
+---
+
+## 路径别名（tsconfig.json）
+
+```json
+{
+  "compilerOptions": {
+    "paths": {
+      "@/*": ["./src/*"],
+      "@/features/*": ["./src/features/*"],
+      "@/shared/*": ["./src/shared/*"],
+      "@/server/*": ["./src/server/*"]
+    }
+  }
+}
+```
+
+---
+
+## 使用位置指引
+
+| 需求 | 位置 |
+| --- | --- |
+| 新页面/路由 | `app/(group)/page.tsx` |
+| 功能组件 | `features/[name]/components/` |
+| Server action（服务端动作） | `features/[name]/actions.ts` |
+| Data fetching（数据获取） | `features/[name]/queries.ts` |
+| 可复用按钮/输入框 | `shared/components/ui/` |
+| 数据库查询 | `server/db/` |
+| 外部 API（应用程序接口）调用 | `server/services/` |

package/.agents/skills/app-builder/tech-stack.md

@@ -0,0 +1,40 @@
+# 技术栈选择（2026）
+
+> Web App（Web 应用）的默认与备选技术方案。
+
+## 默认技术栈（Web App - 2026）
+
+```yaml
+Frontend（前端）:
+  framework（框架）: Next.js 16 (Stable)
+  language（语言）: TypeScript 5.7+
+  styling（样式）: Tailwind CSS v4
+  state（状态）: React 19 Actions / Server Components
+  bundler（构建工具）: Turbopack（Stable for Dev，开发稳定）
+
+Backend（后端）:
+  runtime（运行时）: Node.js 23
+  framework（框架）: Next.js API Routes / Hono（Edge，边缘）
+  validation（校验）: Zod / TypeBox
+
+Database（数据库）:
+  primary（主选）: PostgreSQL
+  orm: Prisma / Drizzle
+  hosting（托管）: Supabase / Neon
+
+Auth（身份认证）:
+  provider（提供商）: Auth.js（v5） / Clerk
+
+Monorepo（多仓）:
+  tool（工具）: Turborepo 2.0
+```
+
+## 替代选项
+
+| Need（需求） | Default（默认） | Alternative（替代方案） |
+| --- | --- | --- |
+| Real-time（实时） | - | Supabase Realtime, Socket.io |
+| File storage（文件存储） | - | Cloudinary, S3 |
+| Payment（支付） | Stripe | LemonSqueezy, Paddle |
+| Email（邮件） | - | Resend, SendGrid |
+| Search（搜索） | - | Algolia, Typesense |

package/.agents/skills/app-builder/templates/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: templates
+description: Project scaffolding templates（项目脚手架模板）。用于从零创建新项目。包含 12 个技术栈模板。
+allowed-tools: Read, Glob, Grep
+---
+
+# Project Templates（项目模板）
+
+> 用于搭建新项目的快速启动模板。
+
+---
+
+##  Selective Reading Rule（选择性阅读规则）
+
+**仅阅读与用户项目类型匹配的模板！**
+
+| Template（模板） | Tech Stack（技术栈） | When to Use（适用场景） |
+| --- | --- | --- |
+| [nextjs-fullstack](nextjs-fullstack/TEMPLATE.md) | Next.js + Prisma | Full-stack web app（全栈 Web 应用） |
+| [nextjs-saas](nextjs-saas/TEMPLATE.md) | Next.js + Stripe | SaaS product（SaaS 产品） |
+| [nextjs-static](nextjs-static/TEMPLATE.md) | Next.js + Framer | Landing page（落地页） |
+| [express-api](express-api/TEMPLATE.md) | Express + JWT | REST API（接口服务） |
+| [python-fastapi](python-fastapi/TEMPLATE.md) | FastAPI | Python API（Python 接口） |
+| [react-native-app](react-native-app/TEMPLATE.md) | Expo + Zustand | Mobile app（移动应用） |
+| [flutter-app](flutter-app/TEMPLATE.md) | Flutter + Riverpod | Cross-platform（跨平台） |
+| [electron-desktop](electron-desktop/TEMPLATE.md) | Electron + React | Desktop app（桌面应用） |
+| [chrome-extension](chrome-extension/TEMPLATE.md) | Chrome MV3 | Browser extension（浏览器扩展） |
+| [cli-tool](cli-tool/TEMPLATE.md) | Node.js + Commander | CLI app（命令行应用） |
+| [monorepo-turborepo](monorepo-turborepo/TEMPLATE.md) | Turborepo + pnpm | Monorepo（单仓） |
+| [astro-static](astro-static/TEMPLATE.md) | Astro + MDX | Blog / Docs（博客/文档） |
+
+---
+
+## Usage（用法）
+
+1. 用户说 “create [type] app（创建 [type] 应用）”
+2. 匹配到合适模板
+3. **仅**阅读该模板的 `TEMPLATE.md`
+4. 遵循其技术栈和结构

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

@@ -0,0 +1,76 @@
+---
+name: astro-static
+description: Astro static site template principles（静态站点模板原则）。Content-focused websites（内容型网站）、blogs（博客）、documentation（文档）。
+---
+
+# Astro Static Site Template（静态站点模板）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） |
+| --- | --- |
+| Framework（框架） | Astro 4.x |
+| Content（内容） | MDX + Content Collections |
+| Styling（样式） | Tailwind CSS |
+| Integrations（集成） | Sitemap（站点地图）、RSS、SEO |
+| Output（输出） | Static/SSG（静态/SSG） |
+
+---
+
+## Directory Structure（目录结构）
+
+```
+project-name/
++-- src/
+|   +-- components/      # .astro components（.astro 组件）
+|   +-- content/         # MDX content（MDX 内容）
+|   |   +-- blog/
+|   |   +-- config.ts    # Collection schemas（内容集合 Schema）
+|   +-- layouts/         # Page layouts（页面布局）
+|   +-- pages/           # File-based routing（基于文件的路由）
+|   +-- styles/
++-- public/              # Static assets（静态资源）
++-- astro.config.mjs
++-- package.json
+```
+
+---
+
+## Key Concepts（关键概念）
+
+| Concept（概念） | Description（说明） |
+| --- | --- |
+| Content Collections（内容集合） | Type-safe content with Zod schemas（使用 Zod Schema 的类型安全内容） |
+| Islands Architecture（群岛架构） | Partial hydration for interactivity（仅对交互部分局部水合） |
+| Zero JS by default（默认零 JS） | Static HTML unless needed（除非需要，否则输出静态 HTML） |
+| MDX Support（MDX 支持） | Markdown with components（带组件的 Markdown） |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. `npm create astro@latest {{name}}`
+2. Add integrations（添加集成）：`npx astro add mdx tailwind sitemap`
+3. Configure `astro.config.mjs`（配置）
+4. Create content collections（创建内容集合）
+5. `npm run dev`
+
+---
+
+## Deployment（部署）
+
+| Platform（平台） | Method（方式） |
+| --- | --- |
+| Vercel | Auto-detected（自动检测） |
+| Netlify | Auto-detected（自动检测） |
+| Cloudflare Pages | Auto-detected（自动检测） |
+| GitHub Pages | Build + deploy action（构建 + 部署工作流） |
+
+---
+
+## Best Practices（最佳实践）
+
+- Use Content Collections for type safety（保证类型安全）
+- Leverage static generation（优先使用静态生成）
+- Add islands only where needed（仅在需要时添加 Islands）
+- Optimize images with Astro Image（使用 Astro Image 优化图片）

package/.agents/skills/app-builder/templates/chrome-extension/TEMPLATE.md

@@ -0,0 +1,92 @@
+---
+name: chrome-extension
+description: Chrome Extension template（扩展模板）原则。Manifest V3（清单规范）、React、TypeScript。
+---
+
+# Chrome Extension Template（扩展模板）
+
+## Tech Stack（技术栈）
+
+| Component（组件） | Technology（技术） |
+| --- | --- |
+| Manifest（清单） | V3 |
+| UI（界面） | React 18 |
+| Language（语言） | TypeScript |
+| Styling（样式） | Tailwind CSS |
+| Bundler（打包器） | Vite |
+| Storage（存储） | Chrome Storage API（存储 API） |
+
+---
+
+## Directory Structure（目录结构）
+
+```
+project-name/
++-- src/
+|   +-- popup/           # Extension popup（扩展弹窗）
+|   +-- options/         # Options page（选项页）
+|   +-- background/      # Service worker（后台）
+|   +-- content/         # Content scripts（内容脚本）
+|   +-- components/
+|   +-- hooks/
+|   +-- lib/
+|       +-- storage.ts   # Chrome storage helpers（Chrome 存储助手）
+|       +-- messaging.ts # Message passing（消息传递）
++-- public/
+|   +-- icons/
+|   +-- manifest.json
++-- package.json
+```
+
+---
+
+## Manifest V3 Concepts（Manifest V3 概念）
+
+| Component（组件） | Purpose（作用） |
+| --- | --- |
+| Service Worker（后台） | Background processing（后台处理） |
+| Content Scripts（内容脚本） | Page injection（页面注入） |
+| Popup（弹窗） | User interface（用户界面） |
+| Options Page（选项页） | Settings（设置） |
+
+---
+
+## Permissions（权限）
+
+| Permission（权限） | Use（用途） |
+| --- | --- |
+| storage | 保存用户数据 |
+| activeTab | 当前标签页访问 |
+| scripting | 注入脚本 |
+| host_permissions | 站点访问 |
+
+---
+
+## Setup Steps（设置步骤）
+
+1. `npm create vite {{name}} -- --template react-ts`
+2. 添加 Chrome 类型：`npm install -D @types/chrome`
+3. 配置 Vite 多入口
+4. 创建 `manifest.json`
+5. `npm run dev`（watch mode，监视模式）
+6. 在 Chrome 中加载：`chrome://extensions` -> Load unpacked（加载已解压扩展）
+
+---
+
+## Development Tips（开发提示）
+
+| Task（任务） | Method（方法） |
+| --- | --- |
+| 调试 Popup（弹窗） | 右键图标 -> Inspect（检查） |
+| 调试 Background（后台） | Extensions page（扩展管理页） -> Service worker（后台） |
+| 调试 Content（内容脚本） | 页面 DevTools（开发者工具）控制台 |
+| Hot Reload（热更新） | `npm run dev`（watch mode） |
+
+---
+
+## Best Practices（最佳实践）
+
+- 使用 type-safe messaging（类型安全的消息传递）
+- 将 Chrome APIs 包装成 Promise（承诺）
+- 最小化权限
+- 优雅处理离线

package/.agents/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/.agents/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/.agents/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）进行类型安全的数据库访问