@nahisaho/shikigami 1.52.0 → 1.53.0

package/.github/skills/shikigami-consulting-framework/SKILL.md

@@ -2,6 +2,7 @@
 name: shikigami-consulting-framework
 description: |
   BCGコンサルティングフレームワーク分析。BCG Growth-Share Matrix, Experience Curve, Strategy Palette等を適用。
+  Use when: フレームワーク分析、SWOT、ポートフォリオ評価、戦略立案、コスト分析、仮説検証、MECE検証が必要な時。
 license: MIT
 ---
 
@@ -266,3 +267,30 @@ graph TD
 - **shikigami-planner**: BCGフレームワーク選択支援
 - **shikigami-deep-research**: 分析に必要なデータ収集
 - **shikigami-writing**: BCG分析結果のレポート化
+
+---
+
+## Gotchas
+
+1. **MECE性の未検証** — フレームワーク適用後、必ず相互排他性(ME)・全体網羅性(CE)・同一粒度の3点を検証。未検証の分析は信頼性不足
+2. **ベンチマーク比較の欠落** — 自社データのみの分析は「So What」が弱い。必ず業界平均・トップ企業との比較を含める
+3. **フレームワークの不適切選択** — 成功条件タイプに合わないフレームワークを適用すると分析品質が低下。推奨マッピング表を参照
+4. **数値裏付けなしの定性分析** — BCG分析は数値データが前提。定性的な印象のみのマトリクス配置は禁止
+5. **仮説なしのデータ収集** — Hypothesis-Driven Approach では Day 1 Answer を先に設定。仮説なしの網羅的データ収集は非効率
+
+---
+
+## Eval Criteria
+
+```
+[CAPABILITY EVAL: consulting-framework]
+Task: BCGフレームワークによる分析実行
+Success Criteria:
+  - [ ] 適切なBCGフレームワーク選択（成功条件タイプに適合）
+  - [ ] MECE性検証（ME✓ CE✓ 同一粒度✓）合格
+  - [ ] 数値データに基づく分析
+  - [ ] ベンチマーク比較を含む
+  - [ ] 経営層への示唆（So What）が明確
+Expected Output: projects/pjXXXXX_*/analysis/*.md
+Test Command: ls projects/pjXXXXX_*/analysis/*.md
+```

package/.github/skills/shikigami-deep-research/SKILL.md

@@ -2,6 +2,7 @@
 name: shikigami-deep-research
 description: |
   反復的深層リサーチ。Think→Report→Action→完了サイクルで高品質調査を実行。
+  Use when: 情報収集、調査、リサーチ、エビデンス収集、ファクトチェック、ソース検証が必要な時。
 license: MIT
 ---
 
@@ -235,3 +236,30 @@ manifest.yaml `personas[].domain_knowledge.level` で調整:
 - **shikigami-planner**: 事前の計画立案
 - **shikigami-consulting-framework**: フレームワーク分析
 - **shikigami-writing**: 最終レポート生成
+
+---
+
+## Gotchas
+
+1. **set_project 未実行で検索開始** — Phase 0 で `set_project` を実行しないと `save_research` が保存先を特定できない。必ずプロジェクト設定後にリサーチ開始
+2. **save_research の呼び忘れ** — search/visit 実行後に `save_research` を呼ばないとリサーチ結果が揮発する。Think→Report→Action 各サイクル完了時に即保存
+3. **信頼度 6.0 未満で次フェーズ移行** — Gate 2→3 は confidence_score ≥ 0.6 が必須。低信頼ソースのみでは通過不可、追加ソース検索が必要
+4. **単一ソースでの結論** — 交差検証率を維持するため最低3ソースが必要。1ソースのみの主張は「未検証」マーク付与
+5. **日付の古いソースへの依存** — 3年超のソースは低信頼（0.5以下）。最新データの追加検索を優先
+
+---
+
+## Eval Criteria
+
+```
+[CAPABILITY EVAL: deep-research]
+Task: 指定トピックの深層リサーチ実行
+Success Criteria:
+  - [ ] 3ソース以上から交差検証済み
+  - [ ] confidence_score ≥ 0.6
+  - [ ] research/ に save_research で保存済み
+  - [ ] 高信頼ソース（.gov/.edu/公式）を1件以上含む
+  - [ ] Think→Report→Action サイクルを2回以上実行
+Expected Output: research/{query}_{timestamp}.md
+Test Command: ls projects/pjXXXXX_*/research/*.md
+```

package/.github/skills/shikigami-planner/SKILL.md

@@ -2,6 +2,7 @@
 name: shikigami-planner
 description: |
   対話的目的探索・計画立案。5 Whys/JTBDで真の目的を発見し、リサーチ計画を策定。
+  Use when: リサーチ開始、プロジェクト初期化、目的の明確化、計画策定、タスク分解が必要な時。
 license: MIT
 ---
 
@@ -182,3 +183,30 @@ deliverables:
 - **shikigami-deep-research**: 計画に基づくリサーチ実行
 - **shikigami-consulting-framework**: フレームワーク分析
 - **shikigami-writing**: 最終レポート生成
+
+---
+
+## Gotchas
+
+1. **ユーザー承認前にプロジェクト作成** — `npx shikigami new` はユーザーが「はい/OK/承認」と回答した後にのみ実行。確認前の実行は禁止
+2. **1問1答ルール違反** — Phase 1 は1度に1つの質問のみ。複数質問の同時提示はユーザーを混乱させる
+3. **3問未満での目的確定** — Gate 1→2 は dialog_count ≥ 3 が必須。早期に「分かった」と判断しても最低3問は実施
+4. **構造化プロンプトの要素欠落** — 6要素（PURPOSE/TARGET/SCOPE/TIMELINE/CONSTRAINTS/DELIVERABLES）全てが必要。推測要素には「（推測）」マーク付与
+5. **set_project の呼び忘れ** — Phase 0 でプロジェクト作成後、必ず `set_project` MCP ツールでコンテキスト設定
+
+---
+
+## Eval Criteria
+
+```
+[CAPABILITY EVAL: planner]
+Task: リサーチプロジェクトの初期化と目的探索
+Success Criteria:
+  - [ ] プロジェクトフォルダ pjXXXXX_*_YYYYMMDD/ 作成済み
+  - [ ] manifest.yaml に true_purpose 記録済み
+  - [ ] 構造化プロンプト 6要素すべて定義
+  - [ ] 対話 3問以上実施
+  - [ ] ユーザー承認キーワード取得後にCLI実行
+Expected Output: projects/pjXXXXX_*/manifest.yaml
+Test Command: cat projects/pjXXXXX_*/manifest.yaml | grep true_purpose
+```

package/.github/skills/shikigami-writing/SKILL.md

@@ -2,6 +2,7 @@
 name: shikigami-writing
 description: |
   レポート生成・品質保証。リサーチ結果を高品質レポートに変換、Qiita対応。
+  Use when: レポート作成、文書生成、Qiita記事執筆、品質チェック、引用整形、思考フロー可視化が必要な時。
 license: MIT
 ---
 
@@ -389,3 +390,30 @@ ASCII図を自動検出してMermaidに変換
 - **shikigami-planner**: 目的・読者の明確化
 - **shikigami-deep-research**: 素材となる調査
 - **shikigami-consulting-framework**: フレームワーク分析
+
+---
+
+## Gotchas
+
+1. **既存レポートの上書き** — 既存ファイルの直接編集は禁止。修正時は必ず新バージョン `[name]-v[X.Y].md` を作成
+2. **引用なしの事実記述** — すべての事実・数値には出典URLが必須。引用なしの主張は品質スコア減点
+3. **Qiitaタグの同義語重複** — `JavaScript` と `JS` の同時使用は禁止。正式名称を1つのみ使用
+4. **品質スコア 7.0 未満で提出** — Gate 4→5 は品質スコア 7/10 以上が必須。不足時は修正サイクル実行
+5. **思考フロー記録の欠落** — ピボット（仮説修正・方針転換）を検出しているのに記録しないと、レポートの信頼性が低下
+
+---
+
+## Eval Criteria
+
+```
+[CAPABILITY EVAL: writing]
+Task: リサーチ結果からレポート生成
+Success Criteria:
+  - [ ] reports/[name]-v[X.Y].md に保存済み
+  - [ ] 全事実・数値に出典URL付与
+  - [ ] 品質スコア 7/10 以上
+  - [ ] consistency_check 合格
+  - [ ] executive_sync 合格
+Expected Output: projects/pjXXXXX_*/reports/*-v*.md
+Test Command: ls projects/pjXXXXX_*/reports/*-v*.md
+```

package/CHANGELOG.md

@@ -5,7 +5,24 @@ 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.52.0] - 2026-02-28
+## [1.53.0] - 2026-04-07
+
+### Fixed
+
+- **MCP Server: `alternative-source-manager.ts` の `js-yaml` 残存修正**
+  - `import * as yaml from 'js-yaml'` → `import yaml from 'yaml'` に移行
+  - `yaml.load()` → `yaml.parse()` に変更
+  - devDependencies から `@types/js-yaml` を削除
+
+### Added
+
+- **Harness 7軸最適化: .github/skills 全スキルの品質強化**
+  - Axis 1 (Tool Coverage): 全スキルの description を「What + Use when」パターンに最適化（LLMルーティング精度向上）
+  - Axis 4 (Memory Persistence): 全スキルに標準化された `## Gotchas` セクション追加（各5項目）
+  - Axis 5 (Eval Coverage): 全スキルに `## Eval Criteria` セクション追加（pass@k評価対応）
+  - Suite: `copilot-instructions.md` 新規作成（WHEN/DOルーティング・フェーズフロー・緊急度ルーティング・共通規約）
+
+## [1.52.1] - 2026-02-28
 
 ### Fixed
 

package/mcp-server/package.json

@@ -36,7 +36,6 @@
     "yaml": "^2.7.0"
   },
   "devDependencies": {
-    "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.0",
     "@types/pdf-parse": "^1.1.4",
     "tsx": "^4.7.0",

package/mcp-server/src/tools/visit/alternative/alternative-source-manager.ts

@@ -11,7 +11,7 @@
 
 import * as fs from 'fs';
 import * as path from 'path';
-import * as yaml from 'js-yaml';
+import yaml from 'yaml';
 import type {
   AlternativeSource,
   AlternativeSourceResult,
@@ -66,7 +66,7 @@ export class AlternativeSourceManager {
     if (fs.existsSync(this.configPath)) {
       try {
         const content = fs.readFileSync(this.configPath, 'utf-8');
-        const config = yaml.load(content) as AlternativeSourcesConfig;
+        const config = yaml.parse(content) as AlternativeSourcesConfig;
 
         if (config.sources) {
           for (const [contentType, sources] of Object.entries(config.sources)) {

package/package.json

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