---

name: project-knowledge description: | This skill should be used when implementing new features, understanding existing patterns, or when the user asks about "project-specific knowledge", "domain knowledge", "business logic", "data schema", "pipeline patterns", "WMAPE", "Bias", "Processor". Also used when the user says "document this pattern", "add to knowledge base", or when recurring patterns are identified. MUST reference before implementing features to ensure consistency with existing patterns. version: 0.3.0

Project Knowledge Base

プロジェクト固有のドメイン知識、データスキーマ、パイプラインパターン、ビジネスロジックを蓄積・参照するスキル。

目的

1. 知識の蓄積: 実装中に発見したパターン・制約・ベストプラクティスを記録
2. 知識の参照: 新機能実装前に既存パターンを確認し、一貫性を保つ
3. 暗黙知の形式化: コードレビューで発見した暗黙のルールを明文化

索引検索（コンテキスト節約）

各referenceファイルはYAML frontmatterにkeywordsとtopicsを持つ。 キーワード検索で関連ファイルを特定し、必要なファイルのみ読み込む。

索引一覧

検索フロー

Copy1. ユーザーの質問/タスクからキーワード抽出
2. 上記索引でマッチするファイルを特定
3. 関連ファイルのみ読み込み
4. 必要な知識を適用

検索例

知識カテゴリ

知識参照フロー

新機能実装前（必須）

1. 索引検索で関連referenceを特定
2. 既存パターンに従った実装を検討
3. 既存パターンがない場合は新規パターンとして記録

実装後

1. 新たなパターン・知見があれば該当referenceに追記
2. YAML frontmatterのkeywordsも更新

矛盾・競合の検出と解決

検出すべき矛盾パターン

矛盾検出時のフロー

Copy1. 矛盾を検出
2. 既存知識と新規情報を明示
3. 以下の選択肢を提示:
   a) 既存知識を維持（新規を破棄）
   b) 新規情報で上書き（既存を更新）
   c) 両方を併記（条件付きで使い分け）
   d) 統合（より正確な定義に修正）
   e) other (ユーザーに説明を求める)
4. ユーザーの決定に従い更新

質問テンプレート

Copy## 知識の矛盾を検出しました

### 既存の知識（{ファイル名}）
{既存の内容}

### 新規の情報
{新しい内容}

### 矛盾点
{何が矛盾しているか}

### 提案
以下のいずれかを選択してください:
1. **既存維持**: {既存を維持する理由}
2. **新規採用**: {新規を採用する理由}（推奨: {理由があれば}）
3. **条件付き併記**: {使い分け条件の案}
4. **統合案**: {統合した場合の定義}

矛盾解決後

1. 選択された方針に従いreferenceを更新
2. 更新履歴として変更理由を記録（該当セクションのコメントまたは末尾に追記）
3. updated日付を更新

知識記録フォーマット

パターン記録

Copy## {パターン名}

### 概要
{1-2文でパターンの目的を説明}

### 適用条件
- {このパターンを使用すべき状況}

### 実装例
{コード例}

### 注意点
- {実装時の注意点}

新規referenceファイル作成時

必ずYAML frontmatterを含める:

Copy---
title: {タイトル}
keywords:
  - {検索キーワード1}
  - {検索キーワード2}
topics:
  - {トピック1}
  - {トピック2}
updated: {YYYY-MM-DD}
---

# {タイトル}
...

知識の更新タイミング

自動的に記録すべき場面

1. 新しいDTO作成時: data-schemas.md に追加
2. 新しいProcessorパターン発見時: pipeline-patterns.md に追加
3. 精度指標の解釈が明確化された時: accuracy-metrics.md に追加
4. データの特性が判明した時: data-characteristics.md に追加

frontmatter更新

知識追加時は該当ファイルのYAML frontmatterも更新:

• keywords: 新しい検索キーワードを追加
• updated: 更新日を更新

参照ファイル

• references/data-schemas.md - DTO定義、カラム仕様、型制約
• references/pipeline-patterns.md - Processor設計、データフロー
• references/accuracy-metrics.md - WMAPE, Bias%, MAREの定義と解釈
• references/data-characteristics.md - データの特徴、外れ値、制約
• references/data-locations.md - 実データのパス、クライアント別構造