@nahisaho/shikigami 1.2.9 → 1.3.0

package/.github/prompts/shikigami-consistency-check.prompt.md

@@ -0,0 +1,165 @@
+---
+mode: agent
+description: レポート内の数値データの整合性を検証し、不整合を検出・修正提案する
+tools: ['shikigami-writing']
+---
+
+# 数値整合性チェックプロンプト
+
+あなたはデータ品質管理の専門家です。
+
+レポート内の数値データを検証し、不整合を検出・修正提案してください。
+
+## チェック対象
+
+| # | チェック項目 | 検出対象 | 例 |
+|---|-------------|---------|-----|
+| 1 | **同一数値の一致** | 同じ指標が複数箇所で異なる値 | ROI=150%（本文） vs ROI=120%（サマリー） |
+| 2 | **計算結果の整合性** | 合計・平均・比率の計算誤り | 内訳合計≠総計 |
+| 3 | **単位の一貫性** | 円/万円/億円の混在 | 1000万円 vs 10,000,000円 |
+| 4 | **時系列の整合性** | 前年比・成長率の計算 | 2024年比+20%なのに数値が合わない |
+
+## 数値抽出パターン
+
+以下のパターンで数値を抽出してください：
+
+### 通貨
+- `¥[\d,]+` - 例: ¥1,000,000
+- `[\d,]+円` - 例: 100万円
+- `\$[\d,.]+` - 例: $1,000.00
+- `USD[\d,.]+` - 例: USD1,000
+
+### パーセンテージ
+- `[\d.]+%` - 例: 15.5%
+
+### 一般数値
+- `[\d,]+(?:\.\d+)?(?:億|万|千)?` - 例: 1,000万、5.5億
+
+## 重要度判定基準
+
+| 重要度 | 基準 | 対象例 |
+|--------|------|--------|
+| 🔴 **高** | 意思決定に直接影響する数値 | ROI, NPV, 売上高, 利益, 市場規模 |
+| 🟡 **中** | 補足的だが重要な数値 | 成長率, シェア, コスト内訳 |
+| 🟢 **低** | 参考情報・補足数値 | 調査サンプル数, 参考値 |
+
+## 検証手順
+
+### Step 1: 数値抽出
+
+レポートからすべての数値を抽出し、以下を記録：
+- **数値の値**: 実際の数値
+- **出現位置**: セクション名、行番号
+- **単位**: 円、万円、億円、%など
+- **文脈**: 何を表す数値か（例: ROI、売上高）
+
+### Step 2: グルーピング
+
+同じ指標を表す数値をグループ化します：
+
+例:
+```
+【グループ: ROI】
+- 本文: 150%（セクション3.2、行45）
+- サマリー: 120%（セクション1、行5）
+- 表: 150%（セクション4.1、表2）
+```
+
+### Step 3: 整合性検証
+
+各グループ内の数値を比較し、不整合を検出：
+
+**同一数値チェック**:
+- グループ内のすべての数値が一致しているか
+
+**計算チェック**:
+- 合計値 = 内訳の合計か
+- 平均値 = 合計 / 件数か
+- 比率 = 部分 / 全体 × 100か
+
+**単位チェック**:
+- 同じ指標が異なる単位で表記されていないか
+- 単位変換が正しいか（1億 = 100,000,000）
+
+### Step 4: 不整合レポート作成
+
+検出された不整合を重要度順にリスト化します。
+
+### Step 5: 修正提案生成
+
+各不整合に対する修正案を提示します：
+- **信頼できるソース**: どの数値を正とするか判断
+- **修正テキスト**: 具体的な修正案
+- **修正理由**: なぜその修正が適切か
+
+## 出力フォーマット
+
+以下のMarkdown形式で結果を出力してください：
+
+```markdown
+## 数値整合性チェック結果
+
+### サマリー
+
+| 項目 | 値 |
+|------|-----|
+| 検出された数値 | {total_numbers}件 |
+| 不整合箇所 | {inconsistencies}件 |
+| 整合性スコア | {score}% |
+
+### 検出結果
+
+{inconsistencies == 0 ? "✅ すべての数値が整合しています" : "⚠️ 以下の不整合が検出されました"}
+
+### 不整合一覧
+
+| # | セクション | 数値A | 数値B | 差異 | 重要度 |
+|---|-----------|-------|-------|------|--------|
+| 1 | {section} | {value_a} | {value_b} | {diff} | 🔴 高 |
+| 2 | {section} | {value_a} | {value_b} | {diff} | 🟡 中 |
+
+### 修正提案
+
+#### 不整合 #1: {description}
+
+**現状**:
+```
+{current_text}
+```
+
+**修正案**:
+```
+{corrected_text}
+```
+
+**修正理由**: {reason}
+
+**信頼度**: {confidence}%
+
+---
+
+#### 不整合 #2: {description}
+
+（同様の形式で続く）
+
+### 検証完了
+
+{all_passed ? "✅ すべての数値が整合しています。レポートの品質は良好です。" : "⚠️ 上記の不整合を修正してください。修正後、再度検証を実行することを推奨します。"}
+```
+
+## 整合性スコア計算
+
+```
+整合性スコア = (1 - (不整合数 / 総数値数)) × 100
+```
+
+| スコア | 評価 |
+|--------|------|
+| 95-100% | ✅ 優良 |
+| 80-94% | 🟡 良好（軽微な修正推奨） |
+| 60-79% | 🟠 要改善 |
+| 0-59% | 🔴 要再作成 |
+
+## 検証対象レポート
+
+{{{ input }}}

package/.github/prompts/shikigami-executive-sync.prompt.md

@@ -0,0 +1,165 @@
+---
+mode: agent
+description: レポート本文とエグゼクティブサマリーの整合性を検証・同期する
+tools: ['shikigami-writing']
+---
+
+# エグゼクティブサマリー同期プロンプト
+
+あなたはビジネスドキュメント管理の専門家です。
+
+レポート本文とエグゼクティブサマリーの整合性を検証し、必要に応じて同期してください。
+
+## 同期対象要素
+
+| # | 要素 | 説明 | チェック内容 |
+|---|------|------|-------------|
+| 1 | **主要結論** | 調査の結論・提言 | 本文の結論がサマリーに反映されているか |
+| 2 | **定量データ** | ROI, NPV, 市場規模等 | 数値が一致しているか |
+| 3 | **リスク・課題** | 主要なリスク項目 | 本文のリスクがサマリーに含まれているか |
+| 4 | **推奨アクション** | 次のステップ | 提言内容が一致しているか |
+
+## エグゼクティブサマリー標準構成
+
+レポートのエグゼクティブサマリーは以下の構成を想定：
+
+```markdown
+## エグゼクティブサマリー
+
+### 調査目的
+[1-2文で目的を記載]
+
+### 主要発見
+1. [発見1]
+2. [発見2]
+3. [発見3]
+
+### 定量的成果
+| 指標 | 値 |
+|------|-----|
+| ROI | X% |
+| NPV | ¥X |
+| 回収期間 | X年 |
+
+### 推奨アクション
+1. [アクション1]
+2. [アクション2]
+
+### リスク・留意点
+- [リスク1]
+- [リスク2]
+```
+
+## 同期手順
+
+### Step 1: サマリー抽出
+
+レポートからエグゼクティブサマリーセクションを特定・抽出します：
+- `## エグゼクティブサマリー` または `## Executive Summary`
+- `## サマリー` または `## Summary`
+- `## 概要` または `## Overview`
+
+### Step 2: 本文解析
+
+レポート本文から以下のセクションを特定・抽出：
+
+| 対象 | 検索セクション |
+|------|---------------|
+| **主要結論** | `## 結論`, `## Conclusion`, `## まとめ` |
+| **定量データ** | `## 財務分析`, `## 分析結果`, 表形式のデータ |
+| **リスク・課題** | `## リスク`, `## 課題`, `## 留意点` |
+| **推奨アクション** | `## 推奨`, `## 提言`, `## 次のステップ` |
+
+### Step 3: 差分検出
+
+サマリーと本文の内容を比較し、差分をリスト化：
+
+**定量データの比較**:
+- サマリーに記載されている数値
+- 本文に記載されている数値（最新・最終版）
+- 差異の有無と内容
+
+**定性データの比較**:
+- 結論の一致度
+- リスクの網羅性
+- アクションの一致度
+
+### Step 4: 更新提案生成
+
+差分に基づき、サマリーの更新案を生成：
+- 古い数値 → 新しい数値
+- 欠落した情報 → 追加
+- 矛盾する記述 → 修正
+
+### Step 5: 適用確認
+
+ユーザーに更新内容を提示し、適用確認を取得します。
+
+## 差分判定基準
+
+| 差分タイプ | 判定 | 対応 |
+|-----------|------|------|
+| **数値の不一致** | 🔴 要更新 | サマリーを本文に合わせる |
+| **結論の変更** | 🔴 要更新 | サマリーの結論を更新 |
+| **リスクの追加** | 🟡 推奨更新 | 重要なリスクをサマリーに追加 |
+| **軽微な表現差異** | 🟢 任意 | 必須ではないが統一推奨 |
+
+## 出力フォーマット
+
+以下のMarkdown形式で結果を出力してください：
+
+```markdown
+## エグゼクティブサマリー同期結果
+
+### 同期ステータス
+
+{synced ? "✅ サマリーと本文は同期されています" : "⚠️ 以下の差分が検出されました"}
+
+### 検出された差分
+
+| # | 項目 | サマリー記載 | 本文記載 | 対応 |
+|---|------|-------------|---------|------|
+| 1 | {item} | {summary_value} | {body_value} | 🔴 要更新 |
+| 2 | {item} | {summary_value} | {body_value} | 🟡 推奨更新 |
+| 3 | {item} | {summary_value} | {body_value} | ✅ 一致 |
+
+### 更新提案
+
+#### 現在のエグゼクティブサマリー
+
+```markdown
+{current_summary}
+```
+
+#### 更新後のエグゼクティブサマリー
+
+```markdown
+{updated_summary}
+```
+
+### 変更点ハイライト
+
+| # | 項目 | 変更前 | 変更後 |
+|---|------|--------|--------|
+| 1 | {item_1} | {old_value} | {new_value} |
+| 2 | {item_2} | {old_value} | {new_value} |
+
+### 適用確認
+
+上記の更新を適用しますか？
+
+- **適用する** → 更新後のサマリーでレポートを更新
+- **一部適用** → 適用する項目を指定してください
+- **適用しない** → 現状のまま維持
+```
+
+## 自動更新モード
+
+`auto_update: true` の場合、確認なしで自動更新を実行します。
+
+⚠️ **注意**: 自動更新モードは、数値の不一致のみを対象とします。
+結論やリスクの変更は、常にユーザー確認を求めます。
+
+## 検証対象レポート
+
+{{{ input }}}

package/.github/prompts/shikigami-financial-analysis.prompt.md

@@ -0,0 +1,170 @@
+---
+mode: agent
+description: 投資対効果（ROI/NPV/回収期間）を自動計算し、財務分析を提供する
+tools: ['shikigami-consulting-framework']
+---
+
+# 財務分析プロンプト
+
+あなたは投資対効果分析の専門家です。
+
+提供されたデータから投資対効果を分析し、意思決定に必要な財務指標を計算してください。
+
+## 計算対象指標
+
+| 指標 | 説明 | 計算式 |
+|------|------|--------|
+| **ROI** | 投資利益率 | ((年間効果額 × 期間) - 投資額) / 投資額 × 100 |
+| **NPV** | 正味現在価値 | Σ(年間効果額 / (1 + 割引率)^t) - 投資額 |
+| **回収期間** | 投資回収に必要な期間 | 投資額 / 年間効果額 |
+
+## デフォルト値
+
+| パラメータ | デフォルト値 | 備考 |
+|-----------|-------------|------|
+| 評価期間 | 5年 | 未指定の場合 |
+| 割引率 | 5% | 未指定の場合 |
+| 粗利率 | **業種別** | 下記ガイドライン参照、未指定時は確認必須 |
+
+## 業種別粗利率ガイドライン
+
+| 業種 | 粗利率目安 | 中央値 |
+|------|-----------|--------|
+| SaaS / ソフトウェア | 70-85% | 77.5% |
+| コンサルティング | 50-70% | 60% |
+| 製造業 | 20-40% | 30% |
+| 小売業 | 25-35% | 30% |
+| 卸売業 | 15-25% | 20% |
+| サービス業 | 40-60% | 50% |
+| フィンテック | 60-80% | 70% |
+| ヘルスケア | 40-60% | 50% |
+
+### 粗利率決定ロジック
+
+**⚠️ 重要**: 粗利率は業種によって大きく異なるため、自動的にデフォルト値を適用しません。
+
+1. `gross_margin` が明示的に指定されている → **その値を使用**
+2. `industry` が指定されている → **業種別中央値を使用**
+3. どちらも未指定の場合 → **ユーザーに質問**:
+
+```
+❓ 粗利率を教えてください
+
+この投資の粗利率は何%ですか？
+業種を教えていただければ、適切な目安を提案できます。
+
+例: 
+- 「SaaS事業なので75%です」
+- 「製造業です」→ 業種目安30%を適用
+```
+
+## 計算手順
+
+### Step 1: データ抽出
+
+入力データから以下を特定してください：
+- **初期投資額**: 導入費用、開発費用、ライセンス費用など
+- **年間効果額**: コスト削減額、収益増加額など
+- **評価期間**: 投資効果を見積もる期間
+- **業種**: 粗利率決定に使用
+
+### Step 2: 粗利率決定
+
+粗利率決定ロジックに従い、適切な粗利率を決定します。
+未指定の場合は、必ずユーザーに確認してください。
+
+### Step 3: 割引率決定
+
+割引率が指定されていない場合：
+- **デフォルト**: 5%
+- **高リスク案件**: 10%（新規事業、技術的不確実性が高い場合）
+- **低リスク案件**: 3%（既存事業の効率化など）
+
+### Step 4: 指標計算
+
+以下の計算を実行：
+
+**ROI（投資利益率）**:
+```
+ROI = ((年間効果額 × 評価期間) - 初期投資額) / 初期投資額 × 100
+```
+
+**NPV（正味現在価値）**:
+```
+NPV = Σ(年間効果額 / (1 + 割引率)^t) - 初期投資額
+    where t = 1 to 評価期間
+```
+
+**回収期間**:
+```
+Payback Period = 初期投資額 / 年間効果額
+```
+
+### Step 5: 感度分析
+
+割引率を変動させた場合のNPVを計算：
+
+| 割引率 | シナリオ |
+|--------|---------|
+| 3% | 楽観シナリオ |
+| 5% | 基本シナリオ |
+| 7% | 保守シナリオ |
+| 10% | 悲観シナリオ |
+
+### Step 6: 投資判断
+
+計算結果に基づき、投資の妥当性を判断：
+
+| 指標 | 判定基準 |
+|------|---------|
+| ROI > 100% | ✅ 投資回収見込みあり |
+| NPV > 0 | ✅ 投資価値あり |
+| 回収期間 < 評価期間 | ✅ 期間内回収可能 |
+
+## 出力フォーマット
+
+以下のMarkdown形式で結果を出力してください：
+
+```markdown
+## 財務分析結果
+
+### 投資概要
+
+| 項目 | 値 |
+|------|-----|
+| 初期投資額 | ¥{investment} |
+| 年間効果額 | ¥{annual_benefit} |
+| 評価期間 | {period_years}年 |
+| 割引率 | {discount_rate}% |
+| 粗利率 | {gross_margin}%（{industry}） |
+
+### 主要指標
+
+| 指標 | 値 | 判定 |
+|------|-----|------|
+| **ROI** | {roi}% | {判定} |
+| **NPV** | ¥{npv} | {判定} |
+| **回収期間** | {payback}年 | {判定} |
+
+### 感度分析（NPV）
+
+| 割引率 | NPV | 判定 |
+|--------|-----|------|
+| 3%（楽観） | ¥{npv_3} | {判定} |
+| 5%（基本） | ¥{npv_5} | {判定} |
+| 7%（保守） | ¥{npv_7} | {判定} |
+| 10%（悲観） | ¥{npv_10} | {判定} |
+
+### 投資判断サマリー
+
+{investment_recommendation}
+
+### 留意事項
+
+- {risk_1}
+- {risk_2}
+```
+
+## 入力データ
+
+{{{ input }}}

package/AGENTS.md

@@ -8,10 +8,11 @@
 
 | 項目 | 詳細 |
 |------|------|
-| **バージョン** | 1.2.0 |
+| **バージョン** | 1.3.0 |
 | **言語** | TypeScript |
 | **ランタイム** | Node.js >= 20.0.0 |
 | **Agent Skills** | 4スキル |
+| **Prompts** | 8プロンプト（v1.3.0で+3追加） |
 | **フレームワーク** | 51定義 |
 | **MCPツール** | 7ツール |
 
@@ -432,7 +433,69 @@ cd mcp-server && npm start
 
 ---
 
-## 📚 プロンプト一覧
+## � 財務分析ワークフロー（v1.3.0 NEW）
+
+投資判断を含むリサーチでは、以下のワークフローを追加実行します。
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│ Financial Analysis Workflow                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│ 1. データ抽出: 投資額・年間効果額・評価期間を特定                    │
+│ 2. 粗利率決定: 業種別ガイドラインまたはユーザー確認                  │
+│ 3. 指標計算: ROI・NPV・回収期間を算出                               │
+│ 4. 感度分析: 割引率4パターン（3%/5%/7%/10%）でNPVを計算             │
+│ 5. 投資判断: 計算結果に基づく推奨を提示                             │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### 業種別粗利率ガイドライン
+
+| 業種 | 粗利率目安 | 中央値 |
+|------|-----------|--------|
+| SaaS / ソフトウェア | 70-85% | 77.5% |
+| コンサルティング | 50-70% | 60% |
+| 製造業 | 20-40% | 30% |
+| 小売業 | 25-35% | 30% |
+| 卸売業 | 15-25% | 20% |
+| サービス業 | 40-60% | 50% |
+| フィンテック | 60-80% | 70% |
+| ヘルスケア | 40-60% | 50% |
+
+**⚠️ 粗利率未指定時は必ずユーザーに確認すること（デフォルト値を自動適用しない）**
+
+**使用プロンプト**: `shikigami-financial-analysis`
+
+---
+
+## ✅ 品質検証ワークフロー（v1.3.0 NEW）
+
+レポート完成前に以下の品質検証を実行します。
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│ Quality Verification Workflow                                        │
+├─────────────────────────────────────────────────────────────────────┤
+│ 1. 数値整合性チェック: 同一数値の一致、計算結果の整合性を検証        │
+│ 2. エグゼクティブサマリー同期: 本文とサマリーの差分を検出・同期      │
+│ 3. 最終レビュー: 上記に問題がなければレポート完成                    │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+### 数値整合性チェック項目
+
+| # | チェック項目 | 検出対象 |
+|---|-------------|---------|
+| 1 | 同一数値の一致 | 同じ指標が複数箇所で異なる値 |
+| 2 | 計算結果の整合性 | 合計・平均・比率の計算誤り |
+| 3 | 単位の一貫性 | 円/万円/億円の混在 |
+| 4 | 時系列の整合性 | 前年比・成長率の計算 |
+
+**使用プロンプト**: `shikigami-consistency-check`, `shikigami-executive-sync`
+
+---
+
+## �📚 プロンプト一覧
 
 | プロンプト | 説明 | 起動方法 |
 |-----------|------|---------|
@@ -441,9 +504,12 @@ cd mcp-server && npm start
 | `shikigami-framework-analysis` | フレームワーク分析を実行 | Phase 3 |
 | `shikigami-report-writing` | レポートを生成 | Phase 4 |
 | `shikigami-full-research` | 統合リサーチを実行 | 全フェーズ |
+| `shikigami-financial-analysis` | 投資対効果（ROI/NPV/回収期間）を計算 | 財務分析時 |
+| `shikigami-consistency-check` | レポート内の数値整合性を検証 | 品質検証時 |
+| `shikigami-executive-sync` | エグゼクティブサマリーと本文を同期 | レポート完成時 |
 
 ---
 
 **Agent**: GitHub Copilot / Claude  
 **Last Updated**: 2026-01-17  
-**Version**: 1.2.0
+**Version**: 1.3.0

package/CHANGELOG.md

@@ -5,6 +5,46 @@ 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.3.0] - 2026-01-17
+
+### Added
+
+#### New Prompts (3 prompts)
+- **shikigami-financial-analysis** (REQ-FIN-001準拠)
+  - ROI（投資利益率）自動計算
+  - NPV（正味現在価値）自動計算
+  - 回収期間自動計算
+  - 業種別粗利率ガイドライン（8業種対応）
+  - 感度分析（割引率4パターン: 3%/5%/7%/10%）
+  - 粗利率未指定時はユーザーに確認（デフォルト値を自動適用しない）
+
+- **shikigami-consistency-check** (REQ-FIN-003準拠)
+  - レポート内の数値整合性検証
+  - 同一数値の一致チェック
+  - 計算結果の整合性検証
+  - 単位の一貫性チェック
+  - 不整合箇所の修正提案生成
+  - 整合性スコア算出
+
+- **shikigami-executive-sync** (REQ-QA-002準拠)
+  - エグゼクティブサマリーと本文の差分検出
+  - 定量データ（ROI/NPV等）の同期
+  - 結論・リスク・推奨アクションの同期
+  - 自動更新モード対応
+
+#### AGENTS.md Updates
+- バージョン 1.2.0 → 1.3.0
+- 財務分析ワークフロー追加
+- 品質検証ワークフロー追加
+- 業種別粗利率ガイドライン追加
+- プロンプト一覧更新（5→8プロンプト）
+
+### Changed
+
+- **プロンプト数**: 5 → 8 (+3)
+
+---
+
 ## [1.1.0] - 2026-01-16
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nahisaho/shikigami",
-  "version": "1.2.9",
+  "version": "1.3.0",
   "description": "GitHub Copilot Agent Skills for Deep Research & Consulting - AI-Powered Research Assistant with 50+ Consulting Frameworks",
   "keywords": [
     "github-copilot",