@nahisaho/shikigami 1.26.0 → 1.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/AGENTS.md +154 -3
  2. package/CHANGELOG.md +50 -0
  3. package/package.json +1 -1
package/AGENTS.md CHANGED
@@ -6,10 +6,13 @@
6
6
 
7
7
  ## ⛔⛔⛔ 最重要ルール - 調査開始前に必ず読め ⛔⛔⛔
8
8
 
9
- > **🚨 警告**: リサーチ・調査・分析の依頼を受けた場合、**Web検索やファイル読み込みを行う前に**、
9
+ > **🚨 警告1**: リサーチ・調査・分析の依頼を受けた場合、**Web検索やファイル読み込みを行う前に**、
10
10
  > 必ず `npx shikigami new <ProjectName>` を実行してプロジェクトフォルダを作成すること。
11
11
  > **プロジェクト作成前の調査行為は禁止。**
12
12
 
13
+ > **🚨 警告2**: search/visitツールを実行したら、**必ず `save_research` MCPツールを呼び出すこと**。
14
+ > 保存しないと**research/ディレクトリに記録が残らない**。詳細は「4.2 リサーチ結果永続化ルール」参照。
15
+
13
16
  ### 正しい実行順序（必ず守ること）
14
17
 
15
18
  ```
@@ -22,6 +25,10 @@
22
25
  │ npx shikigami new <ProjectName> │
23
26
  │ ⚠️ このコマンドを実行するまで調査禁止 │
24
27
  ├─────────────────────────────────────────────────────────────┤
28
+ │ ステップ2.5: ⭐ プロジェクトコンテキスト設定 ⭐ │
29
+ │ {"tool":"set_project","arguments":{"autoDetect":true}}│
30
+ │ ⚠️ これを実行しないとresearch/に保存できない │
31
+ ├─────────────────────────────────────────────────────────────┤
25
32
  │ ステップ3: 作成されたフォルダを確認 │
26
33
  │ projects/pjXXXXX_<Name>_YYYYMMDD/ が存在するか │
27
34
  ├─────────────────────────────────────────────────────────────┤
@@ -33,6 +40,7 @@
33
40
  │ ステップ6: 目的探索（1問1答形式で真の目的を探る） │
34
41
  ├─────────────────────────────────────────────────────────────┤
35
42
  │ ステップ7: ここでようやくWeb検索・調査を開始してよい │
43
+ │ ⭐ search/visit実行後は必ずsave_researchを呼ぶ ⭐│
36
44
  └─────────────────────────────────────────────────────────────┘
37
45
  ```
38
46
 
@@ -45,6 +53,9 @@
45
53
  | プロジェクト作成前に情報収集 | ワークフロー違反 |
46
54
  | 「まず調べてみます」と言う | Phase 0完了前は禁止 |
47
55
  | 依頼を受けてすぐに調査開始 | 必ずプロジェクト作成が先 |
56
+ | **search後にsave_researchを呼ばない** | **research/に保存されない** |
57
+ | **visit後にsave_researchを呼ばない** | **research/に保存されない** |
58
+ | **set_projectを呼ばずに調査開始** | **保存先が不明になる** |
48
59
 
49
60
  ### ✅ 正しい応答例
50
61
 
@@ -300,6 +311,107 @@ approved: true
300
311
  [内容]
301
312
  ```
302
313
 
314
+ ### 4.2 ⛔⛔⛔ リサーチ結果永続化ルール（v1.27.0 必須）⛔⛔⛔
315
+
316
+ > **🚨 最重要**: search/visitツールを実行したら、**必ず `save_research` MCPツールを呼び出してリサーチ結果を保存すること**。
317
+ > **保存しないとresearch/ディレクトリに記録が残らず、ナレッジが散逸する。**
318
+
319
+ #### ⚠️ 必須フロー（Phase 2 で毎回実行）
320
+
321
+ ```
322
+ ┌─────────────────────────────────────────────────────────────┐
323
+ │ ステップ1: プロジェクト設定（Phase 0 完了直後に1回だけ） │
324
+ │ ↓ │
325
+ │ MCPツール: set_project を呼び出す │
326
+ │ {"tool":"set_project","arguments":{"autoDetect":true}}│
327
+ ├─────────────────────────────────────────────────────────────┤
328
+ │ ステップ2: 検索実行 │
329
+ │ ↓ │
330
+ │ shikigami_search / search ツールを実行 │
331
+ ├─────────────────────────────────────────────────────────────┤
332
+ │ ステップ3: ⭐ 検索結果を保存 ⭐ │
333
+ │ ↓ │
334
+ │ MCPツール: save_research を呼び出す │
335
+ │ {"tool":"save_research","arguments":{ │
336
+ │ "content":"検索結果の内容", │
337
+ │ "query":"検索クエリ", │
338
+ │ "source":"search" │
339
+ │ }} │
340
+ ├─────────────────────────────────────────────────────────────┤
341
+ │ ステップ4: URL訪問実行 │
342
+ │ ↓ │
343
+ │ shikigami_visit / visit ツールを実行 │
344
+ ├─────────────────────────────────────────────────────────────┤
345
+ │ ステップ5: ⭐ 訪問結果を保存 ⭐ │
346
+ │ ↓ │
347
+ │ MCPツール: save_research を呼び出す │
348
+ │ {"tool":"save_research","arguments":{ │
349
+ │ "content":"ページ内容の抽出結果", │
350
+ │ "query":"訪問したURL", │
351
+ │ "source":"visit" │
352
+ │ }} │
353
+ ├─────────────────────────────────────────────────────────────┤
354
+ │ ステップ6: 分析・メモを保存（任意だが推奨） │
355
+ │ ↓ │
356
+ │ {"tool":"save_research","arguments":{ │
357
+ │ "content":"分析結果・考察・メモ", │
358
+ │ "query":"分析テーマ", │
359
+ │ "source":"manual" │
360
+ │ }} │
361
+ └─────────────────────────────────────────────────────────────┘
362
+ ```
363
+
364
+ #### ❌ 禁止される行動パターン
365
+
366
+ | 禁止行動 | 理由 |
367
+ |---------|------|
368
+ | searchを実行してsave_researchを呼ばない | 検索結果がresearch/に保存されない |
369
+ | visitを実行してsave_researchを呼ばない | 訪問結果がresearch/に保存されない |
370
+ | set_projectを呼ばずにsave_researchを呼ぶ | 保存先プロジェクトが不明でエラー |
371
+ | search結果を単に表示して次に進む | ナレッジが散逸する |
372
+
373
+ #### ✅ 正しいコード例
374
+
375
+ ```typescript
376
+ // ステップ1: プロジェクト設定（Phase 0完了直後に1回）
377
+ {"tool":"set_project","arguments":{"autoDetect":true}}
378
+
379
+ // ステップ2-3: 検索 → 保存
380
+ {"tool":"shikigami_search","arguments":{"query":"レアメタル市場動向 2025"}}
381
+ // 結果を受け取ったら即座に:
382
+ {"tool":"save_research","arguments":{
383
+ "content":"[検索結果の内容をここにコピー]",
384
+ "query":"レアメタル市場動向 2025",
385
+ "source":"search"
386
+ }}
387
+
388
+ // ステップ4-5: 訪問 → 保存
389
+ {"tool":"shikigami_visit","arguments":{"url":"https://example.com/article"}}
390
+ // 結果を受け取ったら即座に:
391
+ {"tool":"save_research","arguments":{
392
+ "content":"[ページ内容をここにコピー]",
393
+ "query":"https://example.com/article",
394
+ "source":"visit"
395
+ }}
396
+ ```
397
+
398
+ #### 保存されるファイル
399
+
400
+ | sourceパラメータ | 保存先 | ファイル名例 |
401
+ |-----------------|--------|-------------|
402
+ | `"search"` | `research/` | `search_レアメタル市場動向_20260127_143052.md` |
403
+ | `"visit"` | `research/` | `visit_example.com_20260127_143105.md` |
404
+ | `"manual"` | `research/` | `manual_SWOT分析メモ_20260127_143200.md` |
405
+
406
+ #### MCPツール一覧（永続化関連）
407
+
408
+ | ツール | 用途 | 必須タイミング |
409
+ |--------|------|--------------|
410
+ | `set_project` | プロジェクトコンテキスト設定 | Phase 0完了直後（1回） |
411
+ | `get_project` | 現在のプロジェクト確認 | デバッグ時 |
412
+ | `save_research` | リサーチ結果をresearch/に保存 | **search/visit実行後毎回** |
413
+ | `save_prompt` | プロンプトをprompts/に保存 | Phase 0.5 |
414
+
303
415
  ### 5. Citation（引用）ルール
304
416
 
305
417
  **すべてのデータ・事実主張にはソースURLを付与すること。URLなしの参考文献は禁止。**
@@ -398,18 +510,57 @@ approved: true
398
510
 
399
511
  | 項目 | 詳細 |
400
512
  |------|------|
401
- | **バージョン** | 1.22.0 |
513
+ | **バージョン** | 1.27.0 |
402
514
  | **言語** | TypeScript |
403
515
  | **ランタイム** | Node.js >= 20.0.0 |
404
516
  | **Agent Skills** | 4スキル |
405
517
  | **Prompts** | 16プロンプト |
406
518
  | **フレームワーク** | 53定義 |
407
- | **MCPツール** | 7ツール |
519
+ | **MCPツール** | 11ツール |
408
520
  | **レポートテンプレート** | 33種類 |
409
521
  | **テスト数** | 250+ |
410
522
 
411
523
  ---
412
524
 
525
+ ## 🆕 v1.27.0 新機能（リサーチ結果永続化の必須化）
526
+
527
+ ### save_research MCPツールの必須化
528
+
529
+ search/visitツール実行後に**必ず `save_research` MCPツールを呼び出す**ルールを追加しました。これによりリサーチ結果が確実に`research/`ディレクトリに保存されます。
530
+
531
+ #### 必須フロー
532
+
533
+ ```
534
+ npx shikigami new <ProjectName>
535
+ ↓
536
+ set_project(autoDetect: true) ← 新規追加（必須）
537
+ ↓
538
+ search実行 → save_research(source: "search") ← 必須
539
+ ↓
540
+ visit実行 → save_research(source: "visit") ← 必須
541
+ ↓
542
+ 分析メモ → save_research(source: "manual") ← 推奨
543
+ ```
544
+
545
+ #### MCPツール
546
+
547
+ | ツール | 用途 | 必須タイミング |
548
+ |--------|------|--------------|
549
+ | `set_project` | プロジェクトコンテキスト設定 | Phase 0完了直後（1回） |
550
+ | `save_research` | リサーチ結果をresearch/に保存 | **search/visit実行後毎回** |
551
+
552
+ #### 保存されるファイル形式
553
+
554
+ | source | ファイル名例 |
555
+ |--------|-------------|
556
+ | `"search"` | `search_レアメタル市場_20260127_143052.md` |
557
+ | `"visit"` | `visit_example.com_20260127_143105.md` |
558
+ | `"manual"` | `manual_SWOT分析_20260127_143200.md` |
559
+
560
+ 詳細は「4.2 リサーチ結果永続化ルール」セクション参照。
561
+
562
+ ---
563
+
413
564
  ## 🆕 v1.22.0 新機能（Qiita記事作成強化）
414
565
 
415
566
  ### Qiita記事ダイレクト生成 - Writing Rules強制適用
package/CHANGELOG.md CHANGED
@@ -5,6 +5,56 @@ All notable changes to SHIKIGAMI will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.27.0] - 2026-01-27
9
+
10
+ ### Fixed
11
+
12
+ - **リサーチ結果がresearch/に保存されない問題をAGENTS.md強化で修正**
13
+ - 問題: v1.26.0のPromptファイル更新だけでは、AI Agentが`save_research`の存在を認識しない場合がある
14
+ - 原因: AGENTS.md（AI Agentが最初に読むファイル）に`save_research`の必須ルールがなかった
15
+ - 対策: AGENTS.mdの「最重要ルール」と「絶対ルール」セクションに`save_research`必須指示を追加
16
+
17
+ ### Added
18
+
19
+ - **AGENTS.md: 「最重要ルール」セクション強化**
20
+ - 警告2を追加: 「search/visit実行後は必ずsave_researchを呼ぶこと」
21
+ - 実行順序フローに「ステップ2.5: set_project実行」を追加
22
+ - ステップ7に「search/visit後は必ずsave_research」注記を追加
23
+ - 禁止行動パターンに3項目追加（save_research未呼び出し、set_project未実行）
24
+
25
+ - **AGENTS.md: 「4.2 リサーチ結果永続化ルール」セクション新規追加**
26
+ - 必須フロー図解（6ステップ）
27
+ - 禁止行動パターン表
28
+ - 正しいコード例（TypeScript形式）
29
+ - 保存されるファイル形式表
30
+ - MCPツール一覧（永続化関連）
31
+
32
+ - **AGENTS.md: 「v1.27.0 新機能」セクション追加**
33
+ - save_research MCPツールの必須化についての説明
34
+ - 必須フローの簡潔な図解
35
+ - 保存されるファイル形式
36
+
37
+ ### Changed
38
+
39
+ - **AGENTS.md: プロジェクト概要のバージョン更新**
40
+ - バージョン: 1.22.0 → 1.27.0
41
+ - MCPツール数: 7 → 11
42
+
43
+ - **永続化フローの明確化**
44
+ ```
45
+ Phase 0: npx shikigami new <ProjectName>
46
+ ↓
47
+ set_project(autoDetect: true) ← 必須
48
+ ↓
49
+ Phase 2: search → save_research(source: "search") ← 必須
50
+ ↓
51
+ visit → save_research(source: "visit") ← 必須
52
+ ↓
53
+ Phase 3: 分析 → save_research(source: "manual") ← 推奨
54
+ ```
55
+
56
+ ---
57
+
8
58
  ## [1.26.0] - 2026-01-27
9
59
 
10
60
  ### Fixed
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nahisaho/shikigami",
3
- "version": "1.26.0",
3
+ "version": "1.27.0",
4
4
  "description": "GitHub Copilot Agent Skills for Deep Research & Consulting - AI-Powered Research Assistant with 50+ Consulting Frameworks",
5
5
  "keywords": [
6
6
  "github-copilot",