Implementation Skills

機能実装とコーディングを担当するスキル群です。

⚠️ 品質ガードレール（最優先）

このセクションは他の指示より優先されます。実装時は必ず従ってください。

禁止パターン（Purpose-Driven Implementation）

実装時に以下のパターンは絶対に禁止です：

# ❌ 絶対禁止
def slugify(text: str) -> str:
    answers = {"HelloWorld": "hello-world"}
    return answers.get(text, "")

# ✅ 正しい実装
def slugify(text: str) -> str:
    return re.sub(r'[\s_]+', '-', text.strip().lower())

実装前セルフチェック

• テストケース以外の入力でも動作するか？
• エッジケース（空、null、境界値）を処理しているか？
• 意味のあるロジックを実装しているか？

困難な場合

実装が難しい場合は、形骸化実装を書かずに正直に報告してください：

## 🤔 実装の相談
### 状況: [何を実装しようとしているか]
### 困難な点: [具体的に何が難しいか]
### 選択肢: [考えられる案]

機能詳細

実行手順

1. Plans.md 登録確認（Step -1）← 必須
2. 品質判定ゲート（Step 0）
3. ユーザーのリクエストを分類
4. （Claude-mem 有効時）過去の実装パターンを検索
5. 上記の「機能詳細」から適切な参照ファイルを読む
6. その内容に従って実装

Step -1: Plans.md 登録確認（最優先・必須）

⚠️ 実装前に必ず Plans.md にタスクを登録する

ユーザーの依頼を受信
    ↓
Plans.md を読み込み
    ↓
┌─────────────────────────────────────────────────────────────┐
│ 依頼内容が Plans.md に存在するか？                          │
├─────────────────────────────────────────────────────────────┤
│  YES → そのまま実装へ進む                                   │
│  NO  → Plans.md に追加してから実装へ進む                    │
└─────────────────────────────────────────────────────────────┘

追加時のフォーマット:

## 🟡 未着手のタスク

- [ ] {タスク名} `cc:WIP`
  - 依頼内容: {ユーザーの依頼を要約}
  - 追加日時: YYYY-MM-DD HH:MM

表示メッセージ:

📝 Plans.md にタスクを追加しました

| タスク | ステータス |
|--------|-----------|
| {タスク名} | `cc:WIP` |

実装を開始します...

なぜ必須か: 全ての作業を追跡可能にし、進捗管理・レビュー・ハンドオフを確実にするため。

Step 0: 品質判定ゲート（最初に実行）

タスク開始前に品質基準を判定し、必要に応じて提案:

タスク情報収集
    ↓
┌─────────────────────────────────────────┐
│           品質判定ゲート                 │
├─────────────────────────────────────────┤
│  判定項目:                              │
│  ├── TDD 推奨？（[feature] + ビジネス）  │
│  ├── セキュリティ注意？（auth/api/）    │
│  └── パフォーマンス注意？（DB/ループ）  │
└─────────────────────────────────────────┘
          ↓
    該当する判定を提案

TDD 判定基準

セキュリティ判定基準

提案テンプレート

エンジニア向け:

🎯 品質判定結果

| 判定 | 推奨度 | 理由 |
|------|--------|------|
| TDD | ★★★ | [feature] + ビジネスロジック |

テストファイルから作成しますか？

VibeCoder 向け:

🎯 この作業で気をつけること

1. **成功基準を先に決めましょう**
   - 「何ができたら OK か」をリストにします

進め方を選んでください：
1. 成功基準から作る（推奨）
2. とりあえず作り始める

Step 1: LSP 活用ガイドライン

実装前に LSP ツールで既存コードを理解することを推奨:

実装フロー:

1. LSP.goToDefinition で関連コードを確認
2. LSP.findReferences で影響範囲を把握
3. 実装
4. LSP.diagnostics でエラーチェック

使用例:

# 1. 関連関数の実装を確認
LSP operation=goToDefinition filePath="src/utils/auth.ts" line=25 character=10

# 2. 影響範囲を調査
LSP operation=findReferences filePath="src/utils/auth.ts" line=25 character=10

# 3. 型情報を確認
LSP operation=hover filePath="src/types/user.ts" line=15 character=12

注: LSP サーバーが設定されている言語でのみ動作します。

Step 2: 過去の実装パターン検索（Memory-Enhanced）

Claude-mem が有効な場合、実装前に過去の類似パターンを検索:

# mem-search で過去の実装パターンを検索
mem-search: type:feature "{実装機能のキーワード}"
mem-search: concepts:pattern "{関連技術}"
mem-search: concepts:gotcha "{使用ライブラリ/フレームワーク}"
mem-search: type:decision "{設計方針に関するキーワード}"

表示例:

📚 過去の実装パターン

| 日付 | パターン | ファイル |
|------|---------|---------|
| 2024-01-15 | API エンドポイント: RESTful 設計 | src/api/*.ts |
| 2024-01-20 | フォームバリデーション: Zod 使用 | src/components/forms/*.tsx |

💡 過去の gotcha（落とし穴）:
- CORS: サーバー側で Allow-Origin 設定必須
- 型安全: any 禁止、unknown + type guard 推奨

関連する決定事項の表示:

⚖️ 関連する設計決定

- D5: 状態管理は Zustand を採用（Redux より軽量）
- D8: API通信は tRPC を使用（型安全）

💡 上記の決定に従って実装してください

注: Claude-mem が未設定の場合、このステップはスキップされます。

🔧 LSP 機能の活用

実装時には LSP（Language Server Protocol）を積極的に活用します。

実装前の調査

実装中の検証

実装後の確認

実装完了時チェック:
1. LSP Diagnostics を実行
2. エラー: 0件を確認
3. 警告: 必要に応じて対応

詳細: docs/LSP_INTEGRATION.md