# ssot-project-knowledge

> プロジェクト知識検索スキル。SSOTデータベースからプロジェクト情報を効率的に取得し、
AIエージェントがプロジェクトに関するあらゆる質問に回答できるようにする。

Use when:
- ユーザーが「〜について教えて」「〜とは？」と質問したとき
- ユーザーが特定の要件・機能・API・画面について尋ねたとき
- 「影響範囲は？」「関連する〜は？」というトレーサビリティ質問
- 「〜の背景は？」「なぜ〜？」という理由・経緯の質問
- 「〜の進捗は？」「〜の状況は？」という状況確認
- プロジェクト全体像の把握が必要なとき

- Author: Hiroshi Kataoka
- Repository: pri-Kataoka-Hiroshi/kfc_generator2
- Version: 20260126232234
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/pri-Kataoka-Hiroshi/kfc_generator2
- Web: https://mule.run/skillshub/@@pri-Kataoka-Hiroshi/kfc_generator2~ssot-project-knowledge:20260126232234

---

---
name: ssot-project-knowledge
description: |
  プロジェクト知識検索スキル。SSOTデータベースからプロジェクト情報を効率的に取得し、
  AIエージェントがプロジェクトに関するあらゆる質問に回答できるようにする。

  Use when:
  - ユーザーが「〜について教えて」「〜とは？」と質問したとき
  - ユーザーが特定の要件・機能・API・画面について尋ねたとき
  - 「影響範囲は？」「関連する〜は？」というトレーサビリティ質問
  - 「〜の背景は？」「なぜ〜？」という理由・経緯の質問
  - 「〜の進捗は？」「〜の状況は？」という状況確認
  - プロジェクト全体像の把握が必要なとき
location: managed
model: claude-haiku-4-5
---

# SSOT Project Knowledge

プロジェクトに関する質問に回答するための知識検索スキル。
SSOT（Single Source of Truth）データベースから必要な情報を効率的に取得する。

## 概要

このスキルは以下の目的で使用します：

1. **プロジェクト情報の検索** - 特定のエンティティ（機能、要件、APIなど）の詳細を取得
2. **トレーサビリティ追跡** - 問題→要望→要件→機能→実装の関係を追跡
3. **影響分析** - 変更時の影響範囲を特定
4. **進捗確認** - 各レイヤーのステータス別集計

## コマンド選択フロー（重要）

ユーザーの質問に対して、以下のフローで適切なコマンドを選択してください。

### 質問パターン → コマンド対応表

| 質問パターン | 選択コマンド | 例 |
|-------------|-------------|-----|
| ID指定あり（FUNC_*, API_*, SPEC_*等） | `entity <ID>` | `entity FUNC_POINT_GRANT` |
| 「なぜ」「背景」「理由」「経緯」 | `background <ID>` | `background FUNC_CART_ADD` |
| 「影響」「変更したら」「どこに影響」 | `impact <ID>` | `impact SPEC_POINT_MANAGEMENT` |
| 「派生」「下流」「実装は」 | `trace-down <ID>` | `trace-down SPEC_USER_AUTH` |
| 「根拠」「上流」「元は」 | `trace-up <ID>` | `trace-up API_POINT_GRANT` |
| 「進捗」「状況」「統計」 | `stats` | `stats --detail` |
| 「一覧」「リスト」 | `list <type>` | `list functions` |
| キーワードのみ（IDなし） | `search <keyword>` | `search "ポイント"` |
| 「全体像」「サマリー」「概要」 | `summary` | `summary` |

### IDプレフィックス対応表

| プレフィックス | エンティティ種別 |
|---------------|-----------------|
| `FUNC_` | 機能 |
| `SPEC_` | 要件 |
| `RQST_` | 要望 |
| `PROB_` | 問題 |
| `API_` | API |
| `SCR_` | 画面 |
| `BATCH_` | バッチ |
| `GOAL_` | ビジネス目標 |
| `STKH_` | ステークホルダー |
| `BF_` | 業務フロー |

### 注意事項

1. **複合的な質問**: 1つずつコマンドを実行し、結果を組み合わせて回答
2. **曖昧なキーワード**: まず `search` で候補を探し、IDを特定してから `entity` で詳細取得
3. **IDが不明な場合**: `list <type>` で一覧を取得し、該当するIDを特定

## 使用方法

### コマンドライン

```bash
# プロジェクトサマリーを取得
python3 scripts/query_knowledge.py summary

# 特定エンティティの詳細を取得
python3 scripts/query_knowledge.py entity FUNC_USER_REG
python3 scripts/query_knowledge.py entity SPEC_USER_AUTH
python3 scripts/query_knowledge.py entity API_SAVE_USER

# トレーサビリティ（上流→下流）
python3 scripts/query_knowledge.py trace-down PROB_SLOW_PROCESS
python3 scripts/query_knowledge.py trace-down SPEC_USER_AUTH

# トレーサビリティ（下流→上流）
python3 scripts/query_knowledge.py trace-up FUNC_USER_REG
python3 scripts/query_knowledge.py trace-up API_SAVE_USER

# 影響分析
python3 scripts/query_knowledge.py impact SPEC_USER_AUTH
python3 scripts/query_knowledge.py impact API_SAVE_USER

# 進捗・統計
python3 scripts/query_knowledge.py stats
python3 scripts/query_knowledge.py stats --detail

# キーワード検索
python3 scripts/query_knowledge.py search "ポイント"
python3 scripts/query_knowledge.py search "会員" --type function

# 一覧取得
python3 scripts/query_knowledge.py list functions
python3 scripts/query_knowledge.py list requirements
python3 scripts/query_knowledge.py list apis
python3 scripts/query_knowledge.py list screens
python3 scripts/query_knowledge.py list batches
```

### Claude Code内での使用

```
「ssot-project-knowledge スキルを使用して、プロジェクトサマリーを取得してください」
「ssot-project-knowledge スキルを使用して、FUNC_POINT_GRANTの詳細を教えてください」
「ssot-project-knowledge スキルを使用して、SPEC_POINT_MANAGEMENTの影響範囲を調べてください」
```

## 機能詳細

### 1. プロジェクトサマリー (`summary`)

プロジェクト全体の概要を1回のクエリで取得。

**出力内容**:
- プロジェクト基本情報（名前、期間、PM）
- 各レイヤーの件数（ステークホルダー、目標、問題、要望、要件、機能、API、画面、バッチ）
- ステータス別の集計

### 2. エンティティ詳細 (`entity <ID>`)

特定のIDに関する詳細情報を取得。IDのプレフィックスから自動的に種類を判別。

| プレフィックス | エンティティ種別 |
|---------------|-----------------|
| PROJ_ | プロジェクト |
| STKH_ | ステークホルダー |
| GOAL_ | ビジネス目標 |
| PROB_ | 問題 |
| RQST_ | 要望 |
| SPEC_ | 要件 |
| FUNC_ | 機能 |
| API_ | API |
| SCR_ | 画面 |
| BATCH_ | バッチ |

### 3. トレーサビリティ追跡

#### 上流→下流 (`trace-down <ID>`)

指定したIDから派生する下流のエンティティを追跡。

```
問題 → 要望 → 要件 → 機能 → API/画面/バッチ
```

#### 下流→上流 (`trace-up <ID>`)

指定したIDの根拠となる上流のエンティティを追跡。

```
API/画面/バッチ → 機能 → 要件 → 要望 → 問題
```

### 4. 影響分析 (`impact <ID>`)

指定したIDを変更した場合の影響範囲を特定。

**分析対象**:
- 直接関連するエンティティ
- 間接的に影響を受けるエンティティ
- 依存関係のあるマッピング

### 5. 進捗・統計 (`stats`)

各レイヤーのステータス別集計。

**出力内容**:
- ステータス別の件数（Draft, Active, Completed等）
- 完了率
- 未着手の項目数

### 6. キーワード検索 (`search <keyword>`)

キーワードによる横断検索。

**オプション**:
- `--type <type>`: 検索対象を限定（function, requirement, api, screen, batch）

### 7. 一覧取得 (`list <type>`)

指定した種類のエンティティ一覧を取得。

## データソース

| テーブル | 用途 |
|---------|------|
| project_master | プロジェクト基本情報 |
| stakeholder_master | ステークホルダー |
| business_goal | ビジネス目標 |
| problem_definition | 問題定義 |
| request_definition | 要望定義 |
| specification_definition | 要件定義 |
| function_master | 機能一覧 |
| api_master | API一覧 |
| screen_master | 画面一覧 |
| batch_master | バッチ一覧 |
| mapping_* | 各種マッピング（トレーサビリティ用） |

## 出力形式

### テキスト形式（デフォルト）

人間が読みやすいマークダウン形式。

### JSON形式 (`--json`)

プログラムで処理しやすいJSON形式。

```bash
python3 scripts/query_knowledge.py entity FUNC_USER_REG --json
```

## ユースケース例

### Q: 「ポイント付与機能について教えて」

```bash
python3 scripts/query_knowledge.py search "ポイント付与" --type function
python3 scripts/query_knowledge.py entity FUNC_POINT_GRANT
```

### Q: 「この要件を変更したら何に影響する？」

```bash
python3 scripts/query_knowledge.py impact SPEC_POINT_MANAGEMENT
```

### Q: 「なぜこの機能が必要になった？」

```bash
python3 scripts/query_knowledge.py trace-up FUNC_POINT_GRANT
```

### Q: 「プロジェクトの進捗状況は？」

```bash
python3 scripts/query_knowledge.py stats --detail
```

## 依存関係

- Python 3.6+
- sqlite3（標準ライブラリ）
- 外部パッケージ不要

## トラブルシューティング

### データベースが見つからない

```
Error: Database not found at SSOT_db/ssot.db
```

→ プロジェクトルートから実行してください。

### IDが見つからない

```
Warning: Entity 'XXX' not found
```

→ IDのスペルを確認するか、`list`コマンドで存在するIDを確認してください。