perf

非功能需求验证技能。定义、测量和验证性能、可扩展性和可用性。

📖 中文导读:非功能需求验证技能。定义、测量和验证性能、可扩展性和可用性。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: perf description: 非機能要件検証スキル。パフォーマンス・スケーラビリティ・可用性を定義・計測・検証 context: fork arguments:

  • name: mode description: 実行モード(define/measure/verify) required: true
  • name: target description: 検証対象(ページURL/API/コンポーネント) required: false
  • name: requirements description: 非機能要件ファイルパス required: false default: "docs/requirements/nfr.md" allowed-tools:
  • Read
  • Write
  • Glob
  • Grep
  • Bash(npm:*)
  • Bash(npx:*)
  • Bash(lighthouse:*)
  • WebFetch
  • Task
  • TodoWrite

/perf - 非機能要件検証スキル

非機能要件(NFR: Non-Functional Requirements)を定義・計測・検証する。

実行モード

mode=define - 非機能要件定義

/perf mode=define
# → 非機能要件テンプレートを生成

mode=measure - 計測実行

/perf mode=measure target=/dashboard
# → Lighthouse + カスタム計測実行

mode=verify - 要件検証

/perf mode=verify target=/api/users
# → 定義済み要件との比較検証

非機能要件カテゴリ

1. パフォーマンス (Performance)

指標 説明 目標例
LCP Largest Contentful Paint < 2.5s
FID First Input Delay < 100ms
CLS Cumulative Layout Shift < 0.1
TTFB Time to First Byte < 200ms
API Response APIレスポンス時間 p95 < 500ms

2. スケーラビリティ (Scalability)

指標 説明 目標例
Concurrent Users 同時接続ユーザー数 1000+
RPS Requests Per Second 500+
Data Volume 処理可能データ量 100万レコード

3. 可用性 (Availability)

指標 説明 目標例
Uptime 稼働率 99.9%
MTTR 平均復旧時間 < 1時間
MTBF 平均故障間隔 > 30日

4. セキュリティ (Security)

指標 説明 目標例
認証 認証方式 OAuth 2.0 / JWT
暗号化 通信・保存 TLS 1.3 / AES-256
監査 ログ保持期間 90日

非機能要件テンプレート

# 非機能要件定義書 (NFR)

## 1. パフォーマンス要件

### Web Vitals
| 指標 | 目標 | 計測方法 |
|------|------|---------|
| LCP | < 2.5s | Lighthouse |
| FID | < 100ms | Lighthouse |
| CLS | < 0.1 | Lighthouse |
| TTFB | < 200ms | WebPageTest |

### API パフォーマンス
| エンドポイント | p50 | p95 | p99 |
|---------------|-----|-----|-----|
| GET /api/users | 50ms | 200ms | 500ms |
| POST /api/orders | 100ms | 500ms | 1000ms |

### データベース
| クエリ種別 | 目標 |
|-----------|------|
| 単純SELECT | < 10ms |
| JOINクエリ | < 50ms |
| 集計クエリ | < 200ms |

## 2. スケーラビリティ要件

| 項目 | 現在 | 目標 | 上限 |
|------|------|------|------|
| 同時ユーザー | 100 | 1000 | 10000 |
| データ量 | 10万 | 100万 | 1000万 |
| ファイルサイズ | 10MB | 100MB | 1GB |

## 3. 可用性要件

| 項目 | 目標 | 許容ダウンタイム |
|------|------|----------------|
| 月間稼働率 | 99.9% | 43分/月 |
| 計画メンテ | 月1回 | 2時間以内 |
| 障害復旧 | MTTR | 1時間以内 |

## 4. セキュリティ要件

- [ ] OWASP Top 10 対策済み
- [ ] 通信暗号化 (TLS 1.3)
- [ ] 保存データ暗号化
- [ ] 監査ログ 90日保持
- [ ] 年1回 脆弱性診断

計測実行

Lighthouse (Web Vitals)

npx lighthouse https://example.com/dashboard \
  --output=json \
  --output-path=./reports/lighthouse-dashboard.json

API パフォーマンス

// カスタム計測スクリプト
const results = await Promise.all(
  endpoints.map(async (endpoint) => {
    const times = [];
    for (let i = 0; i < 100; i++) {
      const start = performance.now();
      await fetch(endpoint);
      times.push(performance.now() - start);
    }
    return {
      endpoint,
      p50: percentile(times, 50),
      p95: percentile(times, 95),
      p99: percentile(times, 99),
    };
  })
);

検証レポート

## 非機能要件検証レポート

### 検証日時
2026-01-08 23:00 JST

### サマリー
- **総項目数**: 15
- **合格**: 12 (80%)
- **不合格**: 2 (13%)
- **未計測**: 1 (7%)

### パフォーマンス検証結果

| 指標 | 目標 | 実測 | 判定 |
|------|------|------|------|
| LCP | < 2.5s | 1.8s | ✅ PASS |
| FID | < 100ms | 45ms | ✅ PASS |
| CLS | < 0.1 | 0.15 | ❌ FAIL |
| TTFB | < 200ms | 180ms | ✅ PASS |

### API パフォーマンス

| エンドポイント | 目標 p95 | 実測 p95 | 判定 |
|---------------|---------|---------|------|
| GET /api/users | 200ms | 150ms | ✅ PASS |
| POST /api/orders | 500ms | 620ms | ❌ FAIL |

### 不合格項目の改善提案

1. **CLS 0.15 → 目標 0.1**
   - 原因: 画像のwidth/height未指定
   - 対策: next/image で固定サイズ指定

2. **POST /api/orders p95 620ms → 目標 500ms**
   - 原因: DB書き込み待機
   - 対策: 非同期キュー導入検討

### 次回検証予定
- CLS改善後: 2026-01-15
- API最適化後: 2026-01-20

CI統合

# .github/workflows/perf.yml
name: Performance Check

on:
  pull_request:
    branches: [main]

jobs:
  lighthouse:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Lighthouse
        uses: treosh/lighthouse-ci-action@v10
        with:
          urls: |
            https://preview-${{ github.event.pull_request.number }}.vercel.app/
          budgetPath: ./lighthouse-budget.json