fe-kit-cli 0.0.1

package/dist/skills/app-ui-design/references/rules.md

@@ -0,0 +1,127 @@
+---
+description: Review UI code for （App/H5）UI 设计规范 compliance
+argument-hint: <file-or-pattern>
+---
+
+# 设计规范 规则说明）
+
+输出格式遵循 Web Interface Guidelines 的“分组列规则 + 最终 ✓ pass”风格（不包含 source:loc 标记）。
+
+---
+
+## 00. Document Defaults / Global Assumptions
+
+- 设计稿尺寸基准为 750×1624px（适用于 750px）。
+- 规范中按钮/输入框等尺寸单位均为 px（正文为节省空间已省略单位）。
+- 行高规则：文本行高为字号的 1.5 倍；换行每增加一行，增加“文本字高度的 1.5 倍”；行高向上取偶数。
+- 分割线（除错误标识以外）统一为 0.5px，色值 `#EAEAEA`。
+- 页面背景色 `#F3F8FE`；页面卡片内容背景色 `#FFFFFF`。
+- 字重仅使用【L / R / M / B】四档；未标识默认为常规 R。
+- 若无特殊说明，默认（上下左右）居中对齐。
+
+## 01. Layout / Grid System
+
+- 使用等分栅格体系；除去两侧外边距后，栅格居中。
+- 设计稿尺寸以 750×1624px 为基准。
+- 内容区背景色 `#F3F8FE`；栏位 N=6。
+- 栅格参数：外边距 30px；栅格间距 32px；列宽按 \((屏幕宽度 - 外边距×2 - 栅格间距×5) / 6\) 自适应。
+
+## 02. Color System
+
+- 主色（品牌/焦点色）为 `#006ECD`（控件色/文字链）。
+- 页面背景色 `#F3F8FE`（首页/各 Tab 页背景）。
+- press 状态：主色叠加 `#000000` 20%（用于按压反馈）。
+- 渐变色：`linear-gradient(-31deg, #0077E0 60%, #00E070 100%)`。
+- 深黑 `#323953`：标题/重要文本/Tab 切换/输入文本。
+- 中黑 `#5B6175`：正文/表单/正文详情。
+- 深灰 `#949698`：辅助文本/弱文字。
+- 浅灰 `#C1C3CB`：输入框待输入状态。
+- 内容卡片背景色 `#FFFFFF`：一级及以上页面卡片背景。
+- 分割线色 `#EAEAEA`：输入框未输入/复选框默认/分割线。
+- 状态色：`#00C864`（成功）、`#FFE10A`（加载/等待）、`#FB5151`（报错/角标）、`#FF940A`（警告/进行中/toast 警告）。
+
+## 03. Typography
+
+- 中文字号建议：最大 60px、最小 20px；字号为偶数（4 的倍数最佳）；特殊场景可调整但需控制文案长度。
+- 中文默认字体：PingFang SC。
+- 英文/数字默认字体：DIN Alternate。
+
+中文字号语义（示例表述以规范为准）：
+- 60px：结果页大标题（Light 300）。
+- 52px：大标题/引导文案（Regular/Medium）。
+- 42px：Tab 页标题（Bold 700）。
+- 36px：一级标题/导航栏标题/正常按钮文案；32px：二级标题/列表/输入框文案。
+
+英文/数字字号语义：
+- 28px：主要内容/提示文字/卡片按钮文案。
+- 26px：插卡/列表主要内容描述。
+- 24px：摘要/次要信息。
+- 20px：标签/角标。
+
+## 04. Icons
+
+- 图标一致性：设计尺寸保持饱满，保留距边 2–4px；偏长/不饱满图标可通过缩小距边保持视觉大小一致。
+- 线性图标小尺寸：24×24px。
+- 线性图标常规尺寸：44×44px。
+- 金刚区图标：62×62px。
+- 业务图标：60×60px。
+
+## 05. Buttons
+
+- 全局按钮：作用于整个界面的高层级操作；按钮宽度随界面宽度变化；距离两侧边距固定（遵守全局外边距）。
+- 通栏主要按钮尺寸 650×96px；通栏次要按钮与主要按钮同栅格对齐；需提供按下/禁用等状态。
+- 悬浮按钮：位于右下角，距离内容区边缘 30px；尺寸 100×100px。
+- 文字按钮：纯文字或“文字+图标”；颜色必须具备可操作感；文案简短直接；与“文字链”区分（文字链可嵌入段落）。
+- 文字常规按钮高度 60px（宽度随文字自适应）；另有高度 44px 规格（宽度随文字自适应）。
+- 吸底按钮高度 60px（主要/次要并列样式需保持统一高度与对齐）。
+
+## 06. Navigation Bars
+
+- 导航栏应用样式：导航栏高度 100px。
+
+## 07. Tabs
+
+- 标签栏形态：页面顶部标签栏（可返回上一级）；页面内部一级/二级标签栏；二级标签栏支持“更多/展开收起”形态，选中/未选中状态需明确可区分。
+
+## 08. Forms
+
+- 表单组合需覆盖“输入前/输入后”两种状态；提示占位、已输入内容、选择器、日期段等控件状态需一致。
+- 表单控件类型至少包含：标题输入框、日期段选择框、多行文本框、选择框、单行文本框；同一页面内控件规格需统一（避免混用不同高度/字体/间距）。
+- 表单提交区需包含明确主按钮与协议勾选/说明区域（布局需稳定且不挤压主要操作）。
+
+## 09. Lists / Cards
+
+- 列表形态需覆盖：客户列表（含首字母索引）、日历列表等；展开/收起样式需一致且可预期。
+- 卡片型列表（排行榜/产品卡片等）需保证信息层级清晰、操作区（预览/编辑/删除等）布局一致。
+- 展开/收起信息卡（如保单）需保证关键信息在收起态仍可读；展开态信息块对齐一致。
+
+## 10. Toast / Notice / Badges
+
+- 纯文字吐司最小尺寸 `min: 320×120px`；背景 `rgba(0,0,0,0.70)`。
+- 图标+文字吐司尺寸 320×280px；图标用于强化反馈状态（成功/加载/失败等）。
+- 数字红点：一位数 36×36px；多位数为圆角矩形自适应宽度，圆角直径 36px。
+- 角标红点：18×18px，背景 `#FB5151`；带描边时为 `border: 2px solid #FFFFFF`。
+
+## 11. Dialogs
+
+- 对话框标题最长支持 12 字。
+- 对话框按钮文案最长支持 10 字。
+- 多按钮对话框：多于 1 个操作时，后两个为灰色（保持主次清晰）。
+
+## 12. Masks / Overlays
+
+- 遮罩（底部弹窗）：`rgba(0,0,0,0.60)`。
+- 底部弹窗遮罩需预留最小高度 60px（避免贴底造成不可操作/压迫）。
+- 全屏遮罩：`rgba(7,7,7,0.80)`。
+
+## 13. Hero / Carousel (焦点图)
+
+- 焦点图宽度 750px（随屏宽适配时需保持等比/裁切策略一致）。
+- 焦点图顶部遮挡 88px；底部遮挡 73px（内容安全区需避开遮挡）。
+- 关键内容展示建议区间 192px（主信息需落在安全区内）。
+- 焦点图高度示例 353px（若业务调整高度，必须同步更新安全区与遮挡规则）。
+
+## 99. Quick Sanity Check
+
+✓ pass - 若页面满足：750 设计稿体系、30px 外边距与 6 栏栅格、背景 `#F3F8FE` + 卡片 `#FFFFFF`、分割线 `0.5px #EAEAEA`、主色 `#006ECD` 与 press 叠加规则、字号 20–60 且偶数（4 倍数优先）、关键组件尺寸（按钮/吐司/角标/遮罩）与状态一致、交互主次清晰。
+

package/dist/skills/e2e-testing/SKILL.md

@@ -0,0 +1,327 @@
+---
+name: e2e-testing
+description: Playwright E2E testing patterns, Page Object Model, configuration, CI/CD integration, artifact management, and flaky test strategies.
+origin: ECC
+---
+
+# E2E Testing Patterns
+
+Comprehensive Playwright patterns for building stable, fast, and maintainable E2E test suites.
+
+## Test File Organization
+
+```
+tests/
+├── e2e/
+│   ├── auth/
+│   │   ├── login.spec.ts
+│   │   ├── logout.spec.ts
+│   │   └── register.spec.ts
+│   ├── features/
+│   │   ├── browse.spec.ts
+│   │   ├── search.spec.ts
+│   │   └── create.spec.ts
+│   └── api/
+│       └── endpoints.spec.ts
+├── fixtures/
+│   ├── auth.ts
+│   └── data.ts
+└── playwright.config.ts
+```
+
+## Page Object Model (POM)
+
+```typescript
+import { Page, Locator } from '@playwright/test'
+
+export class ItemsPage {
+  readonly page: Page
+  readonly searchInput: Locator
+  readonly itemCards: Locator
+  readonly createButton: Locator
+
+  constructor(page: Page) {
+    this.page = page
+    this.searchInput = page.locator('[data-testid="search-input"]')
+    this.itemCards = page.locator('[data-testid="item-card"]')
+    this.createButton = page.locator('[data-testid="create-btn"]')
+  }
+
+  async goto() {
+    await this.page.goto('/items')
+    await this.page.waitForLoadState('networkidle')
+  }
+
+  async search(query: string) {
+    await this.searchInput.fill(query)
+    await this.page.waitForResponse(resp => resp.url().includes('/api/search'))
+    await this.page.waitForLoadState('networkidle')
+  }
+
+  async getItemCount() {
+    return await this.itemCards.count()
+  }
+}
+```
+
+## Test Structure
+
+```typescript
+import { test, expect } from '@playwright/test'
+import { ItemsPage } from '../../pages/ItemsPage'
+
+test.describe('Item Search', () => {
+  let itemsPage: ItemsPage
+
+  test.beforeEach(async ({ page }) => {
+    itemsPage = new ItemsPage(page)
+    await itemsPage.goto()
+  })
+
+  test('should search by keyword', async ({ page }) => {
+    await itemsPage.search('test')
+
+    const count = await itemsPage.getItemCount()
+    expect(count).toBeGreaterThan(0)
+
+    await expect(itemsPage.itemCards.first()).toContainText(/test/i)
+    await page.screenshot({ path: 'artifacts/search-results.png' })
+  })
+
+  test('should handle no results', async ({ page }) => {
+    await itemsPage.search('xyznonexistent123')
+
+    await expect(page.locator('[data-testid="no-results"]')).toBeVisible()
+    expect(await itemsPage.getItemCount()).toBe(0)
+  })
+})
+```
+
+## Playwright Configuration
+
+```typescript
+import { defineConfig, devices } from '@playwright/test'
+
+export default defineConfig({
+  testDir: './tests/e2e',
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: [
+    ['html', { outputFolder: 'playwright-report' }],
+    ['junit', { outputFile: 'playwright-results.xml' }],
+    ['json', { outputFile: 'playwright-results.json' }]
+  ],
+  use: {
+    baseURL: process.env.BASE_URL || 'http://localhost:3000',
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure',
+    video: 'retain-on-failure',
+    actionTimeout: 10000,
+    navigationTimeout: 30000,
+  },
+  projects: [
+    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
+    { name: 'webkit', use: { ...devices['Desktop Safari'] } },
+    { name: 'mobile-chrome', use: { ...devices['Pixel 5'] } },
+  ],
+  webServer: {
+    command: 'npm run dev',
+    url: 'http://localhost:3000',
+    reuseExistingServer: !process.env.CI,
+    timeout: 120000,
+  },
+})
+```
+
+## Flaky Test Patterns
+
+### Quarantine
+
+```typescript
+test('flaky: complex search', async ({ page }) => {
+  test.fixme(true, 'Flaky - Issue #123')
+  // test code...
+})
+
+test('conditional skip', async ({ page }) => {
+  test.skip(process.env.CI, 'Flaky in CI - Issue #123')
+  // test code...
+})
+```
+
+### Identify Flakiness
+
+```bash
+npx playwright test tests/search.spec.ts --repeat-each=10
+npx playwright test tests/search.spec.ts --retries=3
+```
+
+### Common Causes & Fixes
+
+**Race conditions:**
+```typescript
+// Bad: assumes element is ready
+await page.click('[data-testid="button"]')
+
+// Good: auto-wait locator
+await page.locator('[data-testid="button"]').click()
+```
+
+**Network timing:**
+```typescript
+// Bad: arbitrary timeout
+await page.waitForTimeout(5000)
+
+// Good: wait for specific condition
+await page.waitForResponse(resp => resp.url().includes('/api/data'))
+```
+
+**Animation timing:**
+```typescript
+// Bad: click during animation
+await page.click('[data-testid="menu-item"]')
+
+// Good: wait for stability
+await page.locator('[data-testid="menu-item"]').waitFor({ state: 'visible' })
+await page.waitForLoadState('networkidle')
+await page.locator('[data-testid="menu-item"]').click()
+```
+
+## Artifact Management
+
+### Screenshots
+
+```typescript
+await page.screenshot({ path: 'artifacts/after-login.png' })
+await page.screenshot({ path: 'artifacts/full-page.png', fullPage: true })
+await page.locator('[data-testid="chart"]').screenshot({ path: 'artifacts/chart.png' })
+```
+
+### Traces
+
+```typescript
+await browser.startTracing(page, {
+  path: 'artifacts/trace.json',
+  screenshots: true,
+  snapshots: true,
+})
+// ... test actions ...
+await browser.stopTracing()
+```
+
+### Video
+
+```typescript
+// In playwright.config.ts
+use: {
+  video: 'retain-on-failure',
+  videosPath: 'artifacts/videos/'
+}
+```
+
+## CI/CD Integration
+
+```yaml
+# .github/workflows/e2e.yml
+name: E2E Tests
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npx playwright install --with-deps
+      - run: npx playwright test
+        env:
+          BASE_URL: ${{ vars.STAGING_URL }}
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 30
+```
+
+## Test Report Template
+
+```markdown
+# E2E Test Report
+
+**Date:** YYYY-MM-DD HH:MM
+**Duration:** Xm Ys
+**Status:** PASSING / FAILING
+
+## Summary
+- Total: X | Passed: Y (Z%) | Failed: A | Flaky: B | Skipped: C
+
+## Failed Tests
+
+### test-name
+**File:** `tests/e2e/feature.spec.ts:45`
+**Error:** Expected element to be visible
+**Screenshot:** artifacts/failed.png
+**Recommended Fix:** [description]
+
+## Artifacts
+- HTML Report: playwright-report/index.html
+- Screenshots: artifacts/*.png
+- Videos: artifacts/videos/*.webm
+- Traces: artifacts/*.zip
+```
+
+## Wallet / Web3 Testing
+
+```typescript
+test('wallet connection', async ({ page, context }) => {
+  // Mock wallet provider
+  await context.addInitScript(() => {
+    window.ethereum = {
+      isMetaMask: true,
+      request: async ({ method }) => {
+        if (method === 'eth_requestAccounts')
+          return ['0x1234567890123456789012345678901234567890']
+        if (method === 'eth_chainId') return '0x1'
+      }
+    }
+  })
+
+  await page.goto('/')
+  await page.locator('[data-testid="connect-wallet"]').click()
+  await expect(page.locator('[data-testid="wallet-address"]')).toContainText('0x1234')
+})
+```
+
+## Financial / Critical Flow Testing
+
+```typescript
+test('trade execution', async ({ page }) => {
+  // Skip on production — real money
+  test.skip(process.env.NODE_ENV === 'production', 'Skip on production')
+
+  await page.goto('/markets/test-market')
+  await page.locator('[data-testid="position-yes"]').click()
+  await page.locator('[data-testid="trade-amount"]').fill('1.0')
+
+  // Verify preview
+  const preview = page.locator('[data-testid="trade-preview"]')
+  await expect(preview).toContainText('1.0')
+
+  // Confirm and wait for blockchain
+  await page.locator('[data-testid="confirm-trade"]').click()
+  await page.waitForResponse(
+    resp => resp.url().includes('/api/trade') && resp.status() === 200,
+    { timeout: 30000 }
+  )
+
+  await expect(page.locator('[data-testid="trade-success"]')).toBeVisible()
+})
+```
+