Communitygithub.com

Omar-Obando/qwen-orchestrator

アンチパターン検出・防止スキル。ハードコードされたデータ、非機能的なUI要素、プレースホルダーコード、N+1クエリなど、開発における一般的なアンチパターンをリリース前にキャッチします。

qwen-orchestrator とは?

このスキルは、ソフトウェア開発プロジェクトにおいて「未完成」や「プロフェッショナルでない」と見なされるアンチパターンを検出し、防止するために設計されています。UI/UX、コード品質、データベースクエリ、アーキテクチャ設計など、複数のカテゴリにまたがる明確な禁止事項と必須要件を定義しています。特に「Coming Soon」セクションや非機能ボタン、ハードコードされたデータといったUIアンチパターンに対してゼロトレランスを採用し、N+1クエリやSQLインジェクション、SELECT *、DRY違反などのコードアンチパターンも厳格にチェックします。ウェブサイト構築時には、シングルページではなくマルチページ構成を必須とし、一貫したカラーパレット、SVGアイコンの使用、適切なスペーシングなど、デザインシステムに基づいたプロフェッショナルなUI/UXを強制します。SEO対策として、ユニークなタイトルやメタディスクリプション、構造化データの実装も確認します。このスキルは、Claude CodeやCursorなどのAIエージェントで使用することを想定しており、コード生成やレビューの前に実行することで、品質の高い成果物を保証します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Omar-Obando/qwen-orchestrator/tree/HEAD/skills/anti-pattern

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

アンチパターンスキル — 本物のコードを出荷せよ、飾りではない

このスキルは、ソフトウェアを未完成またはプロフェッショナルでない印象にする最も一般的なアンチパターンを検出し、防止します。

禁止アンチパターン(ゼロトレランス)

UI/UX アンチパターン

❌ 禁止:
- 「近日公開」セクションまたはラベル
- 機能しないボタン(動作するか削除すること)
- どこにも送信しないフォーム
- 本番コンポーネントにおけるハードコードされたダミーデータ
- 動的であるふりをする静的テーブル
- どこにも繋がらないリンク(href="#")
- 「工事中」バナー
- 恒久的に false に設定された機能フラグ
- 明確な説明のない無効化された入力
- 役立つメッセージのない空の状態
- 実際にはページネーションしないページネーション
- 実際には検索しない検索バー
- 同じ結果を返すフィルター
- ユーザーが「ウェブサイト」を要求したときのシングルランディングページ(マルチページ必須)
- CSS を書く前に定義されたカラーパレットがない
- 文書化されたデザインシステムなしのランダムな16進カラー
- ページ間で一貫性のない色(異なる青、異なる間隔)
- ウェブサイト内のどこかにある絵文字(Lucide/Heroicons/Phosphor の SVG アイコンを使用)
- 互いに接触しているセクション(コンテンツブロック間のスペースなし)
- すぐ上のセクションに貼り付いたフッター(余白なし)
- 7つ以上のトップレベル項目があるナビゲーション(乱雑で圧倒的)
- 個別の詳細ページがないサービスページ(/services のみで、/services/web-design がない)
- 個別の詳細ページがない製品ページ(/products のみで、/products/[slug] がない)
- 一般的なサービス説明(1サービスあたり2〜3行では不十分)

✅ 必須:
- 表示されるすべてのボタンは実際のハンドラーをトリガーするか、削除される
- すべてのフォームには API 呼び出しに接続された実際の onSubmit がある
- すべてのリストはローディング状態とともに実際のデータソースから読み込まれる
- すべてのリンクは実際の宛先に移動する
- 空の状態は理由を説明し、次のアクションを提案する
- エラー状態はサーバーからの実際のエラーメッセージを表示する
- ローディング状態は実際の非同期操作中に表示される
- 個別のルートを持つマルチページウェブサイト(Home, About, Services, Contact, Products)
- プロフェッショナルな6色パレット(--color-primary, secondary, accent, bg, surface, text)
- すべてのページで一貫したデザインシステム
- 絵文字はゼロ — SVG アイコンを使用(Lucide, Heroicons, Phosphor)
- セクション間隔: セクション間の最小パディング80px
- フッター: 最小上部パディング128px(上のコンテンツに絶対に触れない)
- ナビゲーション: 最大7項目、グループにはドロップダウン、セカンダリリンクはフッターに
- サービス: 一覧ページ + サービスごとの個別詳細ページ
- 製品: 一覧ページ + 製品ごとの個別詳細ページ
- 各サービス詳細: 説明、プロセス、成果物、価格、FAQ、CTA
- 各製品詳細: ギャラリー、仕様、価格、レビュー、関連製品

ウェブサイトアーキテクチャ アンチパターン

❌ 禁止(ユーザーが「ウェブサイトを作って」と言った場合):
- 唯一のファイルとして index.html を作成する
- すべてのコンテンツを1つのスクロール可能なページに入れる
- 個別ページの代わりにアンカーリンク(#about, #services)を使用する
- 単なるランディングページなのに「ウェブサイト」と呼ぶ
- セクション/ページ間のナビゲーションメニューがない
- ページ間で共有されるヘッダー/フッターがない
- ページごとにユニークなメタタイトル/説明がない

✅ 必須:
- 各セクションに個別のルート/ページ(例: /about, /services, /contact)
- すべてのページにリンクするナビゲーションメニュー
- 共有ヘッダー + フッターコンポーネント
- 各ページにユニークな <title> と <meta description>
- すべてのページで一貫したカラーパレットとタイポグラフィ
- 「ウェブサイト」リクエストには最低5ページ(Home, About, Services, Products/Portfolio, Contact)

コード アンチパターン

❌ 禁止:
- return []; // TODO: implement
- throw new Error('Not implemented');
- // placeholder
- API レスポンスのふりをするハードコードされた配列
- 空のボディを持つ関数
- エラーを黙って飲み込むキャッチブロック
- 本番コード内のコメントアウトされたコード
- 名前付き定数のないマジックナンバー
- コピーペーストされたコード(DRY違反)
- 巨大関数(100行超)
- 深くネストされたコールバック(3レベル超)
- ループ内の N+1 データベースクエリ

✅ 必須:
- すべての関数は実際に動作する実装を持つ
- すべてのエラーはユーザーフィードバック付きで適切に処理される
- 定数は名前が付けられ、文書化される
- コードは DRY — 共有ロジックを抽出する
- 関数は焦点を絞り、40行未満にする

N+1 クエリ検出

❌ 禁止(N+1):
// ユーザーごとに1クエリ発行 = N+1問題
for (const user of users) {
  const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]);
}

✅ 必須(バッチ):
// 合計1クエリのみ発行
const userIds = users.map(u => u.id);
const orders = await db.query(
  'SELECT * FROM orders WHERE user_id IN (?)',
  [userIds]
);
// メモリ内でグループ化
const ordersByUser = groupBy(orders, 'user_id');

SQL アンチパターン

❌ 禁止:
SELECT * FROM users                    -- SELECT * 禁止
WHERE name LIKE '%" + input + "%'     -- SQLインジェクション
ORDER BY RAND()                        -- パフォーマンス低下
HAVING COUNT(*) > 0                    -- WHERE を使用
WHERE YEAR(created_at) = 2024          -- インデックス使用不可

✅ 必須:
SELECT id, name, email FROM users      -- 明示的なカラム
WHERE name LIKE ?                      -- パラメータ化
ORDER BY id DESC LIMIT 20              -- 決定論的ソート
WHERE created_at >= '2024-01-01'       -- インデックスフレンドリー
  AND created_at < '2025-01-01'

検証チェックリスト

成果物が完了とマークされる前に:

一般

  • 「近日公開」や「工事中」がどこにもない
  • すべてのボタンは機能するか削除されている
  • すべてのフォームは実際のエンドポイントに送信される
  • すべてのリストは実際のデータソースから読み込まれる
  • 本番パスにハードコードされたデモデータがない
  • N+1 クエリがない(クエリがあるすべてのループをチェック)
  • 課題参照のない TODO コメントがない
  • エラー状態は実際のエラーを処理する
  • ローディング状態は実際の操作中に表示される

デザイン & UI アンチパターン

  • ウェブサイト内のどこにも絵文字ゼロ(SVG アイコンのみ使用)
  • セクション間の最小パディング80px(接触しない)
  • フッターの最小上部パディング128px(コンテンツに貼り付かない)
  • メインナビゲーションのトップレベル項目は最大7つ
  • セカンダリリンクはメインナビではなくフッターに
  • サービスには個別の詳細ページがある(一覧ページだけではない)
  • 製品には個別の詳細ページがある(一覧ページだけではない)
  • 各サービス詳細には: 説明、プロセス、成果物、CTA
  • 各製品詳細には: ギャラリー、仕様、価格、レビュー
  • 視覚的分離のための交互セクション背景

SEO アンチパターン(ウェブサイトプロジェクト向け)

  • ユニークな <title> と <meta name="description"> のないページがない
  • Open Graph タグ(og:title, og:description, og:image)のないページがない
  • JSON-LD 構造化データ(<script type="application/ld+json">)のないページがない
  • ホーム以外のページに BreadcrumbList スキーマがないページがない
  • 重複した JSON-LD ブロックがない(代わりに @id 参照を使用)
  • robots.txt または sitemap.xml がない
  • alt テキストのない画像がない
  • 正規 URL のないページがない
  • <html lang="xx"> 属性がない
  • 複数の <h1> があるページがない

使用すべきでない場合

以下の場合は、このスキルを使用しないでください:

  • 一般的なコード品質レビューを実行する(より広範な分析には code-review スキルを使用)
  • データベーススキーマを設計する(スキーマ計画には database-design スキルを使用)
  • アプリケーションビジネスロジックを記述する(完全なモジュールには domain-driven スキルを使用)
  • API エンドポイントの実装をレビューする(エンドポイントパターンには api-design スキルを使用)
  • セキュリティ監査を実行する(脆弱性分析には security-auditor スキルを使用)
  • デプロイメント構成を分析する(CI/CD パイプラインには deployment スキルを使用)
  • Git ワークフローまたはバージョン管理をレビューする(ブランチ/コミットには git-workflow スキルを使用)
  • SQL クエリを記述する(クエリ最適化には sql-best-practices スキルを使用)
  • マルチページウェブサイトのレイアウトを設計する(プロフェッショナルなUI/UXには design-system スキルを使用)
  • リファクタリングが必要な既存コードをレビューする(安全な変換には refactoring スキルを使用)

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル