@nahisaho/shikigami 1.1.0

package/.vscode/mcp.json

@@ -0,0 +1,9 @@
+{
+  "servers": {
+    "shikigami": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["${workspaceFolder}/shikigami/mcp-server/dist/index.js"]
+    }
+  }
+}

package/AGENTS.md

@@ -0,0 +1,310 @@
+# SHIKIGAMI - Deep Research & Consulting Agent Skills
+
+> **AI Coding Agent向け**: このファイルはAIエージェント（GitHub Copilot、Claude等）がSHIKIGAMIプロジェクトを理解し、ワークフローを実行するためのガイドです。
+
+## 🎯 プロジェクト概要
+
+**SHIKIGAMI**は、複数情報源を統合してレポートにまとめる作業を自動化し、専門家レベルの分析知識を提供する**GitHub Copilot Agent Skills**パッケージです。
+
+| 項目 | 詳細 |
+|------|------|
+| **バージョン** | 1.0.0 |
+| **言語** | TypeScript |
+| **ランタイム** | Node.js >= 20.0.0 |
+| **Agent Skills** | 4スキル |
+| **フレームワーク** | 51定義 |
+| **MCPツール** | 7ツール |
+
+---
+
+## 📦 アーキテクチャ
+
+### ディレクトリ構造
+
+```
+shikigami/
+├── AGENTS.md              # 本ファイル（AIエージェント向けガイド）
+├── README.md              # プロジェクト説明
+├── package.json           # パッケージ設定
+├── .github/
+│   ├── skills/            # Agent Skills定義
+│   │   ├── shikigami-planner/
+│   │   ├── shikigami-deep-research/
+│   │   ├── shikigami-consulting-framework/
+│   │   └── shikigami-writing/
+│   └── prompts/           # プロンプトテンプレート
+├── mcp-server/            # MCPサーバー（ツール提供）
+│   ├── src/
+│   │   ├── index.ts       # サーバーエントリ
+│   │   ├── config/        # 設定モジュール
+│   │   └── tools/         # ツール実装
+│   └── shikigami.config.example.yaml
+└── .vscode/
+    └── mcp.json           # MCP設定
+```
+
+### Agent Skills（4スキル）
+
+| スキル | 役割 | 主要機能 |
+|--------|------|---------|
+| **shikigami-planner** | 目的探索・計画立案 | 5 Whys分析、JTBD、リサーチ計画 |
+| **shikigami-deep-research** | 反復的深層リサーチ | Think→Report→Action、ソース追跡 |
+| **shikigami-consulting-framework** | フレームワーク分析 | 51フレームワーク、MECE検証 |
+| **shikigami-writing** | レポート生成・品質保証 | ハルシネーション防止、引用管理 |
+
+### MCPツール（7ツール）
+
+| ツール | 説明 | 用途 |
+|--------|------|------|
+| `search` | DuckDuckGo Web検索 | 情報収集フェーズ |
+| `visit` | Jina AI Readerでページ内容抽出 | 詳細調査フェーズ |
+| `parse_file` | ローカルファイル解析 | ドキュメント調査 |
+| `parse_directory` | ディレクトリ再帰解析 | コードベース理解 |
+| `embed` | テキスト埋め込みベクトル生成 | セマンティック検索基盤 |
+| `similarity` | 2テキスト間の類似度計算 | 関連性判定 |
+| `semantic_search` | セマンティック検索 | コンテキスト取得 |
+
+---
+
+## 🔄 統合リサーチワークフロー
+
+### フェーズ概要
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│ Phase 1: Purpose Discovery（目的探索）                              │
+│ ・ユーザーの表層的依頼から「真の目的」を発見                         │
+│ ・5 Whys分析、JTBD分析                                              │
+│ ・リサーチ計画の立案                                                │
+├─────────────────────────────────────────────────────────────────────┤
+│ Phase 2: Deep Research（深層リサーチ）                              │
+│ ・Think→Report→Actionサイクルを反復                                │
+│ ・複数情報源の収集と統合                                            │
+│ ・ソース追跡・交差検証                                              │
+├─────────────────────────────────────────────────────────────────────┤
+│ Phase 3: Framework Analysis（フレームワーク分析）                   │
+│ ・適切なフレームワークの選択                                        │
+│ ・収集情報への適用                                                  │
+│ ・MECE・ロジック品質検証                                            │
+├─────────────────────────────────────────────────────────────────────┤
+│ Phase 4: Report Writing（レポート生成）                             │
+│ ・構造化されたレポート作成                                          │
+│ ・ハルシネーション検出・不確実性マーキング                          │
+│ ・引用管理・ダイアグラム生成                                        │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### フェーズ詳細
+
+#### Phase 1: Purpose Discovery
+
+```yaml
+入力: ユーザーの依頼（表層的な要求）
+処理:
+  1. 5 Whys分析で根本的動機を発見
+  2. JTBD（Jobs To Be Done）分析
+  3. 明確なリサーチ目的の言語化
+  4. 調査範囲・制約の特定
+  5. リサーチ計画の立案
+出力: 
+  - 真の目的（Root Purpose）
+  - リサーチ計画（Research Plan）
+  - 検索クエリリスト
+```
+
+**使用スキル**: `shikigami-planner`
+
+#### Phase 2: Deep Research
+
+```yaml
+入力: リサーチ計画、検索クエリリスト
+処理:
+  LOOP (収束するまで):
+    1. Think: 現状の知識ギャップを分析
+    2. Search: MCPツールで情報収集
+       - search: Web検索
+       - visit: ページ内容取得
+       - parse_file: ローカルファイル解析
+    3. Report: 収集情報を整理・記録
+       - ソースURL/パスを必ず記録
+       - 信頼度評価
+    4. Action: 次のアクションを決定
+       - 追加検索が必要か判断
+       - 情報が十分なら終了
+出力:
+  - 収集情報サマリー
+  - ソースリスト（URL、信頼度）
+  - 残存する知識ギャップ
+```
+
+**使用スキル**: `shikigami-deep-research`  
+**使用ツール**: `search`, `visit`, `parse_file`, `parse_directory`
+
+#### Phase 3: Framework Analysis
+
+```yaml
+入力: 収集情報、分析目的
+処理:
+  1. 適切なフレームワークを選択
+     - 戦略分析: SWOT, 3C, PEST, 5Forces, BCG等
+     - 問題解決: MECE, ロジックツリー, イシューツリー等
+     - 思考整理: ピラミッド構造, PREP等
+     - 意思決定: 意思決定マトリクス, プロコン等
+  2. フレームワークテンプレートを適用
+  3. 収集情報を構造化
+  4. MECE・ロジック品質を検証
+出力:
+  - フレームワーク適用結果（Markdown形式）
+  - 分析インサイト
+  - 推奨アクション
+```
+
+**使用スキル**: `shikigami-consulting-framework`  
+**参照**: `frameworks/` ディレクトリ内の定義ファイル
+
+#### Phase 4: Report Writing
+
+```yaml
+入力: 分析結果、ソースリスト
+処理:
+  1. レポート構造の決定
+     - 調査レポート / Qiita記事 / 提案書等
+  2. 本文作成
+     - ハルシネーション防止チェック
+     - 不確実な情報には❓マーキング
+  3. 引用・参考文献の整理
+  4. ダイアグラム生成（Mermaid）
+  5. 最終レビュー
+出力:
+  - 完成レポート（Markdown形式）
+  - 参考文献リスト
+  - 信頼度評価
+```
+
+**使用スキル**: `shikigami-writing`
+
+---
+
+## 📋 フレームワークライブラリ（51定義）
+
+### カテゴリ別一覧
+
+| カテゴリ | 件数 | 主要フレームワーク |
+|---------|------|-------------------|
+| 戦略分析 | 10 | SWOT, 3C, PEST, 5Forces, BCG, VRIO, GE, アンゾフ, ブルーオーシャン, バリューチェーン |
+| 問題解決 | 7 | MECE, ロジックツリー, イシューツリー, 5 Whys, 空雨傘, As-Is/To-Be, フィッシュボーン |
+| 思考整理 | 3 | ピラミッド構造, So What/Why So, PREP |
+| 意思決定 | 4 | 意思決定マトリクス, プロコン, リスクマトリクス, コストベネフィット |
+| マーケティング | 7 | 4P, 4C, STP, カスタマージャーニー, ペルソナ, AIDMA/AISAS, ポジショニングマップ |
+| 組織分析 | 2 | 7S, RACI |
+| 顧客分析 | 2 | RFM, NPS |
+| イノベーション | 7 | ビジネスモデルキャンバス, リーンキャンバス, VPキャンバス, デザイン思考, SCAMPER, TAM/SAM/SOM, AARRR |
+| プロセス改善 | 3 | PDCA, OODA, ECRS |
+| 汎用ツール | 5 | 5W1H, SMART, OKR, KPT, JTBD |
+
+**参照パス**: `.github/skills/shikigami-consulting-framework/frameworks/`
+
+---
+
+## ⚙️ 設定
+
+### MCP設定（.vscode/mcp.json）
+
+```json
+{
+  "mcpServers": {
+    "shikigami": {
+      "command": "node",
+      "args": ["./mcp-server/dist/index.js"],
+      "env": {}
+    }
+  }
+}
+```
+
+### プロバイダー設定（shikigami.config.yaml）
+
+```yaml
+version: "1.0"
+
+search:
+  provider: duckduckgo
+  options:
+    maxRetries: 3
+    rateLimitMs: 1500
+
+pageFetcher:
+  provider: jina
+  options:
+    rateLimitMs: 1000
+
+embedding:
+  provider: ollama
+  model: nomic-embed-text
+  options:
+    endpoint: http://localhost:11434
+
+# 環境変数で上書き可能:
+# SHIKIGAMI_SEARCH_PROVIDER, JINA_API_KEY, OPENAI_API_KEY, OLLAMA_HOST
+```
+
+---
+
+## 🛠️ 開発コマンド
+
+```bash
+# MCPサーバービルド
+cd mcp-server && npm run build
+
+# MCPサーバー起動（開発）
+cd mcp-server && npm run dev
+
+# MCPサーバー起動（本番）
+cd mcp-server && npm start
+```
+
+---
+
+## 🤝 AI Agent向けガイドライン
+
+### ワークフロー実行時の注意点
+
+1. **フェーズ順序の遵守**: Phase 1→2→3→4 の順序で実行
+2. **ソース追跡必須**: 収集した情報には必ずソースURLを記録
+3. **ハルシネーション防止**: 不確実な情報には❓マーキング
+4. **フレームワーク選択**: 目的に応じて適切なフレームワークを選択
+5. **MECE検証**: 分析結果は漏れなく重複なく整理
+
+### ツール使用時の注意点
+
+1. **search**: バッチ検索可能、レート制限1.5秒間隔
+2. **visit**: Jina AI Reader使用、大きなページは自動切り詰め
+3. **parse_file**: テキスト/コードファイルのみ対応
+4. **embed**: Ollama必須（ローカル）またはOpenAI API（要キー）
+
+### 品質チェックリスト
+
+- [ ] 真の目的が明確に言語化されているか
+- [ ] 複数の情報源から交差検証されているか
+- [ ] 適切なフレームワークが選択されているか
+- [ ] MECE・ロジック品質が担保されているか
+- [ ] すべての主張にソースが紐づいているか
+- [ ] 不確実な情報がマーキングされているか
+
+---
+
+## 📚 プロンプト一覧
+
+| プロンプト | 説明 | 起動方法 |
+|-----------|------|---------|
+| `shikigami-purpose-discovery` | 目的探索を開始 | Phase 1 |
+| `shikigami-deep-research` | Deep Researchを実行 | Phase 2 |
+| `shikigami-framework-analysis` | フレームワーク分析を実行 | Phase 3 |
+| `shikigami-report-writing` | レポートを生成 | Phase 4 |
+| `shikigami-full-research` | 統合リサーチを実行 | 全フェーズ |
+
+---
+
+**Agent**: GitHub Copilot / Claude  
+**Last Updated**: 2026-01-17  
+**Version**: 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,109 @@
+# Changelog
+
+All notable changes to SHIKIGAMI will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.0] - 2026-01-16
+
+### Added
+
+#### MCP Server (`mcp-server/`)
+- **DuckDuckGo Web検索** (REQ-DR-002準拠)
+  - `search` ツール: バッチ検索対応
+  - レート制限: 1.5秒間隔
+  - APIキー不要
+
+- **Jina AI Reader統合** (REQ-DR-002準拠)
+  - `visit` ツール: ページ内容抽出
+  - LLM最適化テキスト変換
+  - レート制限: 1秒間隔
+
+- **VS Code MCP設定** (`.vscode/mcp.json`)
+
+### Changed
+
+- **shikigami-deep-research**: MCPツール呼び出し例を追加
+  - search/visit ツールの使用方法を明確化
+  - Action フェーズにMCPツール呼び出しパターンを追記
+
+---
+
+## [1.0.0] - 2026-01-16
+
+### Added
+
+#### Agent Skills (4 skills)
+- **shikigami-planner**: 対話的目的探索と計画立案
+  - 5 Whys分析、JTBDフレームワーク
+  - インテリジェント質問生成
+  - リサーチ計画の自動立案
+  
+- **shikigami-deep-research**: 反復的深層リサーチ
+  - Think→Report→Action cycle
+  - 複数ソースの交差検証
+  - ソース追跡・信頼性評価
+  - ハルシネーション防止機構
+  
+- **shikigami-consulting-framework**: コンサルティングフレームワーク分析
+  - 50+フレームワーク定義
+  - 自動フレームワーク推薦
+  - MECE検証
+  - ロジック品質チェック
+  
+- **shikigami-writing**: レポート生成・品質保証
+  - 複数フォーマット対応（Executive Summary/Report/Briefing）
+  - ハルシネーション検出
+  - 不確実性マーキング
+  - 引用・参考文献管理
+
+#### Prompts (5 prompts)
+- `shikigami-purpose-discovery.prompt.md`: 目的探索開始
+- `shikigami-deep-research.prompt.md`: Deep Research実行
+- `shikigami-framework-analysis.prompt.md`: フレームワーク分析
+- `shikigami-report-writing.prompt.md`: レポート生成
+- `shikigami-full-research.prompt.md`: 統合リサーチ（全スキル連携）
+
+#### Frameworks (14 definitions)
+- **Strategic Analysis**
+  - SWOT分析
+  - 3C分析
+  - PEST分析
+  - 5Forces分析
+  
+- **Problem Solving**
+  - MECE
+  - ロジックツリー
+  - 5 Whys
+  
+- **Thinking**
+  - ピラミッド構造
+  
+- **Marketing**
+  - 4P分析
+  - STP分析
+  
+- **Innovation**
+  - ビジネスモデルキャンバス
+  
+- **Decision Making**
+  - 意思決定マトリクス
+  
+- **General**
+  - 5W1H
+  - JTBD
+
+### Technical Details
+- GitHub Copilot Agent Skills (Markdown format)
+- YAML frontmatter for skill metadata
+- Mermaid diagrams for visualization
+- Extensible framework definition structure
+
+---
+
+## 設計ドキュメント
+
+- 要件定義: `storage/specs/REQ-SHIKIGAMI-001.md`
+- 設計書: `storage/design/DES-SHIKIGAMI-001.md`
+- タスク分解: `storage/specs/TSK-SHIKIGAMI-001.md`

package/README.md

@@ -0,0 +1,144 @@
+# SHIKIGAMI
+
+**GitHub Copilot Agent Skills for Deep Research & Consulting**
+
+複数情報源を統合してレポートにまとめる作業を自動化し、専門家レベルの分析知識を提供するAgent Skillsパッケージです。
+
+## 🎯 できること
+
+- **対話的目的探索**: ユーザーの表層的な依頼から「真の目的」を探索
+- **Deep Research**: WebResearcherパラダイムに基づく反復的深層リサーチ
+- **フレームワーク分析**: 50+のコンサルティングフレームワークを適用
+- **高品質レポート生成**: ハルシネーション防止、ソース追跡、引用管理
+
+## 📦 インストール
+
+このリポジトリを VS Code ワークスペースに追加するだけで使用できます。
+
+```bash
+git clone https://github.com/nahisaho/SHIKIGAMI.git
+```
+
+## 🔧 Agent Skills
+
+### shikigami-planner
+対話的目的探索・計画立案スキル。
+
+- 5 Whys分析で根本的な動機を発見
+- JTBD（Jobs To Be Done）分析
+- リサーチ計画の自動立案
+
+### shikigami-deep-research
+反復的深層リサーチスキル。
+
+- Think→Report→Action サイクル
+- 複数情報源の統合
+- ソース追跡・交差検証
+- ハルシネーション防止
+
+### shikigami-consulting-framework
+コンサルティングフレームワーク分析スキル。
+
+- 50+のビジネスフレームワーク
+- SWOT, 3C, PEST, MECE, ピラミッド構造など
+- MECE・ロジック品質検証
+
+### shikigami-writing
+レポート生成・品質保証スキル。
+
+- 調査レポート、Qiita記事テンプレート
+- ハルシネーション検出
+- 不確実性マーキング
+- 引用管理・Mermaidダイアグラム生成
+
+## 📝 Prompts
+
+| プロンプト | 説明 |
+|-----------|------|
+| `shikigami-purpose-discovery` | 目的探索を開始 |
+| `shikigami-deep-research` | Deep Researchを実行 |
+| `shikigami-framework-analysis` | フレームワーク分析を実行 |
+| `shikigami-report-writing` | レポートを生成 |
+| `shikigami-full-research` | 統合リサーチを実行 |
+
+## 🗂️ ディレクトリ構造
+
+```
+shikigami/
+├── .github/
+│   ├── skills/
+│   │   ├── shikigami-planner/
+│   │   │   └── SKILL.md
+│   │   ├── shikigami-deep-research/
+│   │   │   └── SKILL.md
+│   │   ├── shikigami-consulting-framework/
+│   │   │   ├── SKILL.md
+│   │   │   └── frameworks/
+│   │   │       ├── README.md
+│   │   │       ├── strategic/
+│   │   │       │   ├── swot.md
+│   │   │       │   └── 3c.md
+│   │   │       ├── problem-solving/
+│   │   │       │   └── mece.md
+│   │   │       └── thinking/
+│   │   │           └── pyramid.md
+│   │   └── shikigami-writing/
+│   │       └── SKILL.md
+│   └── prompts/
+│       ├── shikigami-purpose-discovery.prompt.md
+│       ├── shikigami-deep-research.prompt.md
+│       ├── shikigami-framework-analysis.prompt.md
+│       ├── shikigami-report-writing.prompt.md
+│       └── shikigami-full-research.prompt.md
+└── README.md
+```
+
+## 📚 フレームワーク一覧
+
+### 戦略分析
+- SWOT分析、3C分析、PEST分析、5Forces、VRIO
+- バリューチェーン、アンゾフマトリクス、BCGマトリクス
+
+### 問題解決
+- MECE、ロジックツリー、イシューツリー、5 Whys
+- 空・雨・傘、フィッシュボーン図
+
+### 思考整理
+- ピラミッド構造、So What / Why So、PREP
+
+### マーケティング
+- 4P/4C、STP、カスタマージャーニー、ペルソナ分析
+
+## 🚀 使用例
+
+### 例1: 市場調査
+
+```
+ユーザー: 「AI市場について調べて」
+
+SHIKIGAMI:
+1. [Planner] 「なぜAI市場を調べる必要がありますか？」→ 真の目的を探索
+2. [Deep Research] 複数ソースから情報収集・統合
+3. [Framework] 3C分析、PEST分析を適用
+4. [Writing] 構造化レポートを生成
+```
+
+### 例2: 競合分析
+
+```
+ユーザー: 「競合A社を分析して」
+
+SHIKIGAMI:
+1. [Planner] 分析の目的・用途を確認
+2. [Deep Research] A社の情報を網羅的に収集
+3. [Framework] SWOT分析を適用
+4. [Writing] 分析レポートを生成
+```
+
+## 📄 ライセンス
+
+MIT License
+
+## 👤 作者
+
+nahisaho

package/mcp-server/README.md

@@ -0,0 +1,80 @@
+# SHIKIGAMI MCP Server
+
+Deep Research用のMCPサーバー。DuckDuckGo検索とJina AI Readerを使用してリアルタイムWeb検索を実行。
+
+## インストール
+
+```bash
+cd mcp-server
+npm install
+npm run build
+```
+
+## ツール
+
+### search
+
+DuckDuckGoでバッチWeb検索を実行。
+
+```json
+{
+  "query": "TypeScript best practices",
+  "maxResults": 10
+}
+```
+
+または複数クエリ:
+
+```json
+{
+  "query": ["TypeScript best practices", "TypeScript design patterns"],
+  "maxResults": 5
+}
+```
+
+### visit
+
+Webページを訪問し、内容をLLM用にクリーンなテキストとして抽出。
+
+```json
+{
+  "url": "https://example.com/article",
+  "goal": "主要なポイントを抽出"
+}
+```
+
+または複数URL:
+
+```json
+{
+  "url": ["https://example.com/1", "https://example.com/2"]
+}
+```
+
+## VS Code設定
+
+`.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "shikigami": {
+      "command": "node",
+      "args": ["${workspaceFolder}/shikigami/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+## 要件準拠
+
+- **REQ-DR-002**: DuckDuckGo Web検索 ✅
+- **REQ-CS-004**: search/visit ツール ✅
+- **レート制限**: 1.5秒間隔（DuckDuckGo）、1秒間隔（Jina AI）
+
+## 検索プロバイダー
+
+| プロバイダー | 用途 | APIキー |
+|-------------|------|---------|
+| DuckDuckGo | Web検索 | 不要 |
+| Jina AI Reader | ページ内容抽出 | 不要 |