@nahisaho/shikigami 1.47.0 → 1.49.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 +115 -10
  2. package/CHANGELOG.md +15 -0
  3. package/package.json +1 -1
package/AGENTS.md CHANGED
@@ -40,7 +40,7 @@ VIOLATION = WORKFLOW FAILURE
40
40
 
41
41
  ---
42
42
 
43
- ## Critical Rules (4 Absolute Prohibitions)
43
+ ## Critical Rules (5 Absolute Prohibitions)
44
44
 
45
45
  **⚠️ IMPORTANT: These rules MUST be followed. Violation breaks the research workflow.**
46
46
 
@@ -207,6 +207,36 @@ FORBIDDEN: Continuing without saving user input
207
207
  CONSEQUENCE: Conversation history will be lost if not saved
208
208
  ```
209
209
 
210
+ ### Prohibition 5: PDF Reference via Download and Text Conversion
211
+
212
+ ```
213
+ WHEN: Referencing a PDF document in Deep Research
214
+ DO:
215
+ 1. Create research directory if not exists:
216
+ mkdir -p <project_path>/research
217
+ 2. Download PDF using wget:
218
+ wget -O <project_path>/research/<filename>.pdf <pdf_url>
219
+ 3. Convert PDF to text using pdftotext:
220
+ pdftotext <project_path>/research/<filename>.pdf <project_path>/research/<filename>.txt
221
+ 4. Read and reference the converted text file
222
+ 5. Save the extracted content via save_research
223
+
224
+ EXAMPLE:
225
+ 1. mkdir -p projects/pj00001_AIResearch/research
226
+ 2. wget -O projects/pj00001_AIResearch/research/paper.pdf https://example.com/paper.pdf
227
+ 3. pdftotext projects/pj00001_AIResearch/research/paper.pdf projects/pj00001_AIResearch/research/paper.txt
228
+ 4. Read paper.txt and extract relevant information
229
+ 5. save_research(content: <extracted_content>, source: "pdf", query: "paper.pdf")
230
+
231
+ FORBIDDEN:
232
+ - Attempting to read PDF binary directly
233
+ - Skipping pdftotext conversion step
234
+ - Saving PDF to locations other than research directory
235
+ - Referencing PDF content without save_research
236
+
237
+ CONSEQUENCE: PDF content will be unreadable or lost
238
+ ```
239
+
210
240
  ### Mandatory MCP Call Sequence
211
241
 
212
242
  Every search/visit operation MUST follow this pattern:
@@ -311,10 +341,11 @@ When user says "project created", "created project", or similar:
311
341
  2. **(Phase 0)** **Save Original Prompt** → `save_prompt(type: "original")`
312
342
  3. **(Phase 1)** **Prompt Optimization** → Structure into 6 elements → Display → **WAIT for user approval**
313
343
  4. **(Phase 2)** **Purpose Discovery** → Discover true purpose through 1Q1A dialogue
314
- 5. **(Phase 3)** **Deep Research** → Think→Search→Report→Action cycle
315
- 6. **(Phase 4)** **Framework Analysis** → Apply SWOT/3C/PEST etc.
316
- 7. **(Phase 5)** **Report Generation** → Select template → Write report → Quality check → **WAIT for approval**
317
- 8. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
344
+ 5. **(Phase 2.5)** **Knowledge Inheritance** → Search past projects Inherit if relevant (optional)
345
+ 6. **(Phase 3)** **Deep Research** → Think→Search→Report→Action cycle
346
+ 7. **(Phase 4)** **Framework Analysis** → Apply SWOT/3C/PEST etc.
347
+ 8. **(Phase 5)** **Report Generation** → Select template Write report → Quality check → **WAIT for approval**
348
+ 9. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
318
349
 
319
350
  ### Case B: New research request (no project yet)
320
351
 
@@ -327,10 +358,11 @@ When receiving a new research request:
327
358
  5. **(Phase 0)** **Verify Folder** → Confirm `projects/pjXXXXX_<Name>_YYYYMMDD/` exists
328
359
  6. **(Phase 1)** **Prompt Optimization** → Structure into 6 elements → Display → **WAIT for user approval**
329
360
  7. **(Phase 2)** **Purpose Discovery** → Discover true purpose through 1Q1A dialogue
330
- 8. **(Phase 3)** **Deep Research** → Think→Search→Report→Action cycle
331
- 9. **(Phase 4)** **Framework Analysis** → Apply SWOT/3C/PEST etc.
332
- 10. **(Phase 5)** **Report Generation** → Select template → Write report → Quality check → **WAIT for approval**
333
- 11. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
361
+ 8. **(Phase 2.5)** **Knowledge Inheritance** → Search past projects Inherit if relevant (optional)
362
+ 9. **(Phase 3)** **Deep Research** → Think→Search→Report→Action cycle
363
+ 10. **(Phase 4)** **Framework Analysis** → Apply SWOT/3C/PEST etc.
364
+ 11. **(Phase 5)** **Report Generation** → Select template Write report → Quality check → **WAIT for approval**
365
+ 12. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
334
366
 
335
367
  **MANDATORY APPROVAL POINTS** (must wait for user before proceeding):
336
368
  - Case B Step 1: Project name confirmation
@@ -455,6 +487,79 @@ OUTPUT: True purpose, research plan, search query list
455
487
  - CONSTRAINT: Time, budget, scope limitations?
456
488
  - SUCCESS: How do you define success?
457
489
 
490
+ ### Phase 2.5: Knowledge Inheritance (Optional)
491
+
492
+ ```
493
+ WHEN: Phase 2 completed, before starting Phase 3
494
+ DO:
495
+ 1. Search past projects for related topics:
496
+ - Use semantic_search across all projects/*/research/ and projects/*/reports/
497
+ - Query: user's research topic + key concepts from Phase 2
498
+ 2. If related projects found (similarity > 0.7):
499
+ - List related projects with summary
500
+ - Ask user: "関連する過去プロジェクトが見つかりました。継承しますか?"
501
+ 3. If user approves inheritance:
502
+ - Create research/inherited/ directory
503
+ - Copy relevant files with source tracking
504
+ - Update manifest.yaml with inheritance info
505
+ 4. Adjust Phase 3 research plan to focus on:
506
+ - Updates since last research (time-based delta)
507
+ - Gaps not covered in previous research
508
+ - New perspectives requested by user
509
+ OUTPUT: Inherited knowledge list, adjusted research plan
510
+ ```
511
+
512
+ **Related Project Display Format**:
513
+ ```markdown
514
+ ## 関連する過去プロジェクト
515
+
516
+ | Project | Date | Topic | Similarity | Key Findings |
517
+ |---------|------|-------|------------|-------------|
518
+ | pj00001_AIMarket_20251015 | 2025-10-15 | AI市場調査 | 0.85 | 市場規橐500億円, 成長率15% |
519
+ | pj00003_TechTrend_20251201 | 2025-12-01 | 技術トレンド | 0.72 | LLM採用率拡大 |
520
+
521
+ 継承しますか? (はい/いいえ/選択して継承)
522
+ ```
523
+
524
+ **Inheritance Directory Structure**:
525
+ ```
526
+ projects/pjXXXXX_NewProject_YYYYMMDD/
527
+ ├── research/
528
+ │ ├── inherited/ # 継承ナレッジ
529
+ │ │ ├── INHERITANCE_LOG.md # 継承元追跡
530
+ │ │ ├── pj00001_market-data.md # 継承ファイル
531
+ │ │ └── pj00003_tech-trends.md # 継承ファイル
532
+ │ └── search_*.md # 新規調査
533
+ ```
534
+
535
+ **INHERITANCE_LOG.md Format**:
536
+ ```markdown
537
+ # Knowledge Inheritance Log
538
+
539
+ ## Inherited From
540
+ | Source Project | Files | Inherited Date | Reason |
541
+ |----------------|-------|----------------|--------|
542
+ | pj00001_AIMarket_20251015 | market-data.md | 2026-01-28 | 市場規模データの再利用 |
543
+
544
+ ## Delta Research Focus
545
+ - [ ] 2025年10月以降の市場変化
546
+ - [ ] 新規参入企業の動向
547
+ - [ ] 規制環境の変化
548
+ ```
549
+
550
+ **Delta Research Rules**:
551
+ ```
552
+ WHEN: Knowledge inherited from past project
553
+ DO:
554
+ 1. Check publication dates of inherited data
555
+ 2. Focus new searches on:
556
+ - Time period: [inherited_data_date] to [today]
557
+ - Query modifier: "2025年以降" or "latest" or "recent"
558
+ 3. Compare new findings with inherited data
559
+ 4. Mark changes with (Δ) in report:
560
+ - 市場規模: 500億円 → 580億円 (Δ+16%)
561
+ ```
562
+
458
563
  ### Phase 3: Deep Research
459
564
 
460
565
  ```
@@ -1024,4 +1129,4 @@ DO: Auto-detect Shift_JIS/EUC-JP/ISO-2022-JP and convert to UTF-8
1024
1129
  ---
1025
1130
 
1026
1131
  **Last Updated**: 2026-01-28
1027
- **Version**: 1.47.0
1132
+ **Version**: 1.48.0
package/CHANGELOG.md CHANGED
@@ -5,6 +5,21 @@ 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.48.0] - 2026-01-28
9
+
10
+ ### Added
11
+
12
+ - **AGENTS.md: Knowledge Inheritance (Phase 2.5)**
13
+ - New optional phase between Purpose Discovery and Deep Research
14
+ - Semantic search across past projects (research/ and reports/)
15
+ - Related project display with similarity scores
16
+ - User confirmation before inheritance
17
+ - `research/inherited/` directory structure
18
+ - `INHERITANCE_LOG.md` tracking format
19
+ - Delta Research Rules for time-based updates
20
+ - Change markers (Δ) for comparing inherited vs new data
21
+ - Workflow updated: Case A (8→9 steps), Case B (11→12 steps)
22
+
8
23
  ## [1.47.0] - 2026-01-28
9
24
 
10
25
  ### Changed
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nahisaho/shikigami",
3
- "version": "1.47.0",
3
+ "version": "1.49.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",