@nahisaho/shikigami 1.44.0 → 1.48.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 +247 -19
  2. package/CHANGELOG.md +70 -0
  3. package/package.json +1 -1
package/AGENTS.md CHANGED
@@ -311,10 +311,11 @@ When user says "project created", "created project", or similar:
311
311
  2. **(Phase 0)** **Save Original Prompt** → `save_prompt(type: "original")`
312
312
  3. **(Phase 1)** **Prompt Optimization** → Structure into 6 elements → Display → **WAIT for user approval**
313
313
  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** → Create structured report
317
- 8. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
314
+ 5. **(Phase 2.5)** **Knowledge Inheritance** → Search past projects Inherit if relevant (optional)
315
+ 6. **(Phase 3)** **Deep Research** → Think→Search→Report→Action cycle
316
+ 7. **(Phase 4)** **Framework Analysis** → Apply SWOT/3C/PEST etc.
317
+ 8. **(Phase 5)** **Report Generation** → Select template Write report → Quality check → **WAIT for approval**
318
+ 9. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
318
319
 
319
320
  ### Case B: New research request (no project yet)
320
321
 
@@ -327,14 +328,16 @@ When receiving a new research request:
327
328
  5. **(Phase 0)** **Verify Folder** → Confirm `projects/pjXXXXX_<Name>_YYYYMMDD/` exists
328
329
  6. **(Phase 1)** **Prompt Optimization** → Structure into 6 elements → Display → **WAIT for user approval**
329
330
  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** → Create structured report
333
- 11. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
331
+ 8. **(Phase 2.5)** **Knowledge Inheritance** → Search past projects Inherit if relevant (optional)
332
+ 9. **(Phase 3)** **Deep Research** → Think→Search→Report→Action cycle
333
+ 10. **(Phase 4)** **Framework Analysis** → Apply SWOT/3C/PEST etc.
334
+ 11. **(Phase 5)** **Report Generation** → Select template Write report → Quality check → **WAIT for approval**
335
+ 12. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
334
336
 
335
337
  **MANDATORY APPROVAL POINTS** (must wait for user before proceeding):
336
338
  - Case B Step 1: Project name confirmation
337
339
  - Phase 1 (both cases): Structured prompt approval
340
+ - Phase 5→6 (both cases): Quality check approval
338
341
 
339
342
  ---
340
343
 
@@ -454,6 +457,79 @@ OUTPUT: True purpose, research plan, search query list
454
457
  - CONSTRAINT: Time, budget, scope limitations?
455
458
  - SUCCESS: How do you define success?
456
459
 
460
+ ### Phase 2.5: Knowledge Inheritance (Optional)
461
+
462
+ ```
463
+ WHEN: Phase 2 completed, before starting Phase 3
464
+ DO:
465
+ 1. Search past projects for related topics:
466
+ - Use semantic_search across all projects/*/research/ and projects/*/reports/
467
+ - Query: user's research topic + key concepts from Phase 2
468
+ 2. If related projects found (similarity > 0.7):
469
+ - List related projects with summary
470
+ - Ask user: "関連する過去プロジェクトが見つかりました。継承しますか?"
471
+ 3. If user approves inheritance:
472
+ - Create research/inherited/ directory
473
+ - Copy relevant files with source tracking
474
+ - Update manifest.yaml with inheritance info
475
+ 4. Adjust Phase 3 research plan to focus on:
476
+ - Updates since last research (time-based delta)
477
+ - Gaps not covered in previous research
478
+ - New perspectives requested by user
479
+ OUTPUT: Inherited knowledge list, adjusted research plan
480
+ ```
481
+
482
+ **Related Project Display Format**:
483
+ ```markdown
484
+ ## 関連する過去プロジェクト
485
+
486
+ | Project | Date | Topic | Similarity | Key Findings |
487
+ |---------|------|-------|------------|-------------|
488
+ | pj00001_AIMarket_20251015 | 2025-10-15 | AI市場調査 | 0.85 | 市場規橐500億円, 成長率15% |
489
+ | pj00003_TechTrend_20251201 | 2025-12-01 | 技術トレンド | 0.72 | LLM採用率拡大 |
490
+
491
+ 継承しますか? (はい/いいえ/選択して継承)
492
+ ```
493
+
494
+ **Inheritance Directory Structure**:
495
+ ```
496
+ projects/pjXXXXX_NewProject_YYYYMMDD/
497
+ ├── research/
498
+ │ ├── inherited/ # 継承ナレッジ
499
+ │ │ ├── INHERITANCE_LOG.md # 継承元追跡
500
+ │ │ ├── pj00001_market-data.md # 継承ファイル
501
+ │ │ └── pj00003_tech-trends.md # 継承ファイル
502
+ │ └── search_*.md # 新規調査
503
+ ```
504
+
505
+ **INHERITANCE_LOG.md Format**:
506
+ ```markdown
507
+ # Knowledge Inheritance Log
508
+
509
+ ## Inherited From
510
+ | Source Project | Files | Inherited Date | Reason |
511
+ |----------------|-------|----------------|--------|
512
+ | pj00001_AIMarket_20251015 | market-data.md | 2026-01-28 | 市場規模データの再利用 |
513
+
514
+ ## Delta Research Focus
515
+ - [ ] 2025年10月以降の市場変化
516
+ - [ ] 新規参入企業の動向
517
+ - [ ] 規制環境の変化
518
+ ```
519
+
520
+ **Delta Research Rules**:
521
+ ```
522
+ WHEN: Knowledge inherited from past project
523
+ DO:
524
+ 1. Check publication dates of inherited data
525
+ 2. Focus new searches on:
526
+ - Time period: [inherited_data_date] to [today]
527
+ - Query modifier: "2025年以降" or "latest" or "recent"
528
+ 3. Compare new findings with inherited data
529
+ 4. Mark changes with (Δ) in report:
530
+ - 市場規模: 500億円 → 580億円 (Δ+16%)
531
+ ```
532
+
457
533
  ### Phase 3: Deep Research
458
534
 
459
535
  ```
@@ -545,16 +621,85 @@ OUTPUT: Completed report (under reports/), reference list
545
621
  ```
546
622
 
547
623
  **Template Selection Criteria**:
548
- | Report Type | Template | Use When |
549
- |-------------|----------|----------|
550
- | Research Report | research-report | General investigation, market research, technology assessment |
551
- | Proposal | proposal | Recommendations, action plans, business cases |
552
- | Qiita Article | qiita-article | Technical content for publication |
553
- | Executive Summary | executive-summary | Brief overview for decision makers |
554
- | Comparison Report | comparison-report | Product/service/technology comparisons |
555
- | Feasibility Study | feasibility-study | Viability assessment, go/no-go decisions |
556
- | Competitive Analysis | competitive-analysis | Competitor landscape, positioning |
557
- | Technical Report | technical-report | Deep technical investigation |
624
+
625
+ **Category 1: Approval & Decision**
626
+ | Purpose Keywords | Template | Use When |
627
+ |------------------|----------|----------|
628
+ | 予算承認、投資申請、コスト承認 | budget-approval | Budget/investment approval requests |
629
+ | 即時承認、緊急承認、迅速決定 | immediate-approval | Time-sensitive approvals |
630
+ | 段階承認、フェーズ承認、マイルストーン | staged-approval | Multi-phase approval processes |
631
+ | パイロット、試験導入、PoC承認 | pilot-approval | Pilot/trial approvals |
632
+ | 変更要求、変更管理、スコープ変更 | change-request | Change requests, scope changes |
633
+
634
+ **Category 2: Analysis & Research**
635
+ | Purpose Keywords | Template | Use When |
636
+ |------------------|----------|----------|
637
+ | 市場調査、市場分析、マーケット | market-analysis | Market research, industry analysis |
638
+ | 競合分析、競合調査、ライバル | competitive-analysis | Competitor landscape analysis |
639
+ | ユーザー調査、UXリサーチ、顧客理解 | user-research | User/customer research |
640
+ | リスク評価、リスク分析、脆弱性 | risk-assessment | Risk assessment, vulnerability analysis |
641
+ | デューデリジェンス、M&A、投資判断 | due-diligence | Due diligence, M&A evaluation |
642
+ | ABテスト、実験結果、比較実験 | ab-test | A/B test results, experiment reports |
643
+
644
+ **Category 3: Vendor & Procurement**
645
+ | Purpose Keywords | Template | Use When |
646
+ |------------------|----------|----------|
647
+ | ベンダー評価、製品選定、ツール選定 | vendor-evaluation | Vendor/product evaluation |
648
+ | RFI、情報提供依頼、事前調査 | rfi | Request for Information |
649
+ | RFP、提案依頼、入札 | rfp | Request for Proposal |
650
+ | SLA、サービスレベル、契約条件 | sla | SLA definition, service contracts |
651
+
652
+ **Category 4: Technical & Security**
653
+ | Purpose Keywords | Template | Use When |
654
+ |------------------|----------|----------|
655
+ | 技術調査、技術評価、アーキテクチャ | technical-report | Deep technical investigation |
656
+ | セキュリティ評価、脆弱性診断、監査 | security-assessment | Security audits, assessments |
657
+ | コンプライアンス、規制対応、法令遵守 | compliance | Compliance reports, regulatory |
658
+
659
+ **Category 5: Business & Strategy**
660
+ | Purpose Keywords | Template | Use When |
661
+ |------------------|----------|----------|
662
+ | ビジネスケース、投資対効果、ROI | business-case | Business case, ROI analysis |
663
+ | エグゼクティブサマリー、経営報告 | executive-summary | Brief overview for executives |
664
+ | ホワイトペーパー、技術解説、啓蒙 | white-paper | Thought leadership, technical papers |
665
+ | 検討資料、比較検討、オプション分析 | consideration | Options analysis, consideration docs |
666
+
667
+ **Category 6: Project & Operations**
668
+ | Purpose Keywords | Template | Use When |
669
+ |------------------|----------|----------|
670
+ | プロジェクト状況、進捗報告、ステータス | project-status | Project status reports |
671
+ | ポストモーテム、振り返り、障害報告 | post-mortem | Incident reviews, retrospectives |
672
+ | ロードマップ、製品計画、開発計画 | product-roadmap | Product/development roadmaps |
673
+ | QBR、四半期レビュー、業績報告 | qbr | Quarterly business reviews |
674
+
675
+ **Category 7: Sales & Customer**
676
+ | Purpose Keywords | Template | Use When |
677
+ |------------------|----------|----------|
678
+ | 営業資料、セールス、提案書 | sales-playbook | Sales enablement materials |
679
+ | 顧客成功事例、ケーススタディ、導入事例 | customer-success | Customer success stories |
680
+
681
+ **Category 8: Learning & Collaboration**
682
+ | Purpose Keywords | Template | Use When |
683
+ |------------------|----------|----------|
684
+ | 研修資料、トレーニング、教育 | training-material | Training/education materials |
685
+ | ワークショップ、ファシリテーション | workshop | Workshop design, facilitation |
686
+ | インタビューガイド、ヒアリング | interview-guide | Interview/hearing guides |
687
+ | 共同研究、産学連携、研究提案 | joint-research-proposal | Joint research proposals |
688
+ | 思考フロー、分析過程、ロジック展開 | thinking-flow-report | Thinking process documentation |
689
+
690
+ **Template Selection Flow**:
691
+ ```
692
+ WHEN: Phase 5 starts
693
+ DO:
694
+ 1. Extract purpose keywords from user's original request
695
+ 2. Match keywords against Template Selection Criteria tables
696
+ 3. If multiple matches, prioritize by:
697
+ a. Exact keyword match
698
+ b. Category relevance
699
+ c. User's stated output format
700
+ 4. If no match found, use 'consideration' as default
701
+ 5. Confirm template selection with user before writing
702
+ ```
558
703
 
559
704
  **CRITICAL**: Always use `shikigami-report-template` skill to load the appropriate template BEFORE writing. Template provides:
560
705
  - Required sections and structure
@@ -611,6 +756,89 @@ OUTPUT: Completed report (under reports/), reference list
611
756
  | 4→5 | 1+ framework applied, numerical verification done | Not required |
612
757
  | 5→6 | Report exists, quality check passed, citations complete | **Required** |
613
758
 
759
+ ### Quality Checklist (Phase 5→6 Gate)
760
+
761
+ ```
762
+ WHEN: Report draft completed, before Phase 6
763
+ DO: Execute ALL checks below. Report CANNOT proceed to Phase 6 until all items pass.
764
+ ```
765
+
766
+ **1. Numerical Consistency Check** ✅
767
+ | Check Item | How to Verify | FAIL Condition |
768
+ |------------|---------------|----------------|
769
+ | Source attribution | Every number has [[n]] citation | Any number without citation |
770
+ | Percentage totals | Sum of percentages = 100% (or explicitly explained) | Silent deviation from 100% |
771
+ | Text-table match | Numbers in body text match tables/charts | Any discrepancy |
772
+ | Unit correctness | 億/万/thousand/million used correctly | Unit mismatch or confusion |
773
+ | Time series order | Chronological data in correct sequence | Year/date ordering errors |
774
+ | Calculation accuracy | Derived numbers (growth rate, averages) are correct | Math errors |
775
+
776
+ **2. Citation Completeness Check** 📚
777
+ | Check Item | How to Verify | FAIL Condition |
778
+ |------------|---------------|----------------|
779
+ | Inline citations | All facts/claims have [[n]] format | Uncited factual statements |
780
+ | References list | All [[n]] appear in References section | Missing reference entries |
781
+ | URL validity | All URLs are accessible | 404 or dead links |
782
+ | No vague sources | No "various sources", "it is said that" | Vague attributions |
783
+ | Date recorded | All references include access date | Missing dates |
784
+
785
+ **3. Content Consistency Check** 🔄
786
+ | Check Item | How to Verify | FAIL Condition |
787
+ |------------|---------------|----------------|
788
+ | Executive summary sync | Summary numbers match body text | Any discrepancy |
789
+ | Conclusion alignment | Conclusions supported by analysis | Unsupported claims |
790
+ | Conflict markers handled | All (?), (⚡), (💭) items addressed | Unresolved conflicts |
791
+ | MECE coverage | No gaps or overlaps in analysis | Logical gaps |
792
+
793
+ **4. Format & Structure Check** 📋
794
+ | Check Item | How to Verify | FAIL Condition |
795
+ |------------|---------------|----------------|
796
+ | Template compliance | All required sections present | Missing sections |
797
+ | Heading hierarchy | Proper H1→H2→H3 structure | Broken hierarchy |
798
+ | Table formatting | Tables render correctly | Malformed tables |
799
+ | Link formatting | All links work correctly | Broken markdown links |
800
+
801
+ **Quality Check Execution Flow**:
802
+ ```
803
+ Phase 5 Complete
804
+
805
+ [1] Run Numerical Consistency Check
806
+ ↓ (All pass?)
807
+ [2] Run Citation Completeness Check
808
+ ↓ (All pass?)
809
+ [3] Run Content Consistency Check
810
+ ↓ (All pass?)
811
+ [4] Run Format & Structure Check
812
+ ↓ (All pass?)
813
+ Generate Quality Report Summary
814
+
815
+ Request User Approval for Phase 6
816
+ ```
817
+
818
+ **Quality Report Format**:
819
+ ```markdown
820
+ ## Quality Check Results
821
+
822
+ | Category | Status | Issues Found |
823
+ |----------|--------|-------------|
824
+ | Numerical Consistency | ✅ PASS / ❌ FAIL | [count] issues |
825
+ | Citation Completeness | ✅ PASS / ❌ FAIL | [count] issues |
826
+ | Content Consistency | ✅ PASS / ❌ FAIL | [count] issues |
827
+ | Format & Structure | ✅ PASS / ❌ FAIL | [count] issues |
828
+
829
+ ### Issues to Address (if any)
830
+ 1. [Issue description and location]
831
+ 2. [Issue description and location]
832
+ ```
833
+
834
+ **Auto-Fix Rules**:
835
+ | Issue Type | Auto-Fix Action |
836
+ |------------|----------------|
837
+ | Missing citation | Flag with ⚠️, request source |
838
+ | Percentage ≠ 100% | Add "(その他: X%)" or note |
839
+ | Unit confusion | Standardize to larger unit |
840
+ | Dead URL | Attempt Wayback Machine recovery |
841
+
614
842
  ---
615
843
 
616
844
  ## File Saving Rules
@@ -871,4 +1099,4 @@ DO: Auto-detect Shift_JIS/EUC-JP/ISO-2022-JP and convert to UTF-8
871
1099
  ---
872
1100
 
873
1101
  **Last Updated**: 2026-01-28
874
- **Version**: 1.44.0
1102
+ **Version**: 1.48.0
package/CHANGELOG.md CHANGED
@@ -5,6 +5,76 @@ 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
+
23
+ ## [1.47.0] - 2026-01-28
24
+
25
+ ### Changed
26
+
27
+ - **AGENTS.md: Integrate template selection & quality check into workflow overview**
28
+ - Case A Phase 5: "Create structured report" → "Select template → Write report → Quality check → **WAIT for approval**"
29
+ - Case B Phase 5: Same update
30
+ - Added Phase 5→6 to MANDATORY APPROVAL POINTS
31
+ - Quality check approval now required before Phase 6
32
+
33
+ ## [1.46.0] - 2026-01-28
34
+
35
+ ### Added
36
+
37
+ - **AGENTS.md: Detailed Quality Checklist (Phase 5→6 Gate)**
38
+ - **Numerical Consistency Check**: 6 items
39
+ - Source attribution, percentage totals, text-table match
40
+ - Unit correctness, time series order, calculation accuracy
41
+ - **Citation Completeness Check**: 5 items
42
+ - Inline citations, references list, URL validity
43
+ - No vague sources, date recorded
44
+ - **Content Consistency Check**: 4 items
45
+ - Executive summary sync, conclusion alignment
46
+ - Conflict markers handled, MECE coverage
47
+ - **Format & Structure Check**: 4 items
48
+ - Template compliance, heading hierarchy
49
+ - Table formatting, link formatting
50
+ - Quality Check Execution Flow diagram
51
+ - Quality Report Format template
52
+ - Auto-Fix Rules for common issues
53
+
54
+ ## [1.45.0] - 2026-01-28
55
+
56
+ ### Added
57
+
58
+ - **AGENTS.md: Complete Template Selection Criteria (33 templates)**
59
+ - Category 1: Approval & Decision (5 templates)
60
+ - budget-approval, immediate-approval, staged-approval, pilot-approval, change-request
61
+ - Category 2: Analysis & Research (6 templates)
62
+ - market-analysis, competitive-analysis, user-research, risk-assessment, due-diligence, ab-test
63
+ - Category 3: Vendor & Procurement (4 templates)
64
+ - vendor-evaluation, rfi, rfp, sla
65
+ - Category 4: Technical & Security (3 templates)
66
+ - technical-report, security-assessment, compliance
67
+ - Category 5: Business & Strategy (4 templates)
68
+ - business-case, executive-summary, white-paper, consideration
69
+ - Category 6: Project & Operations (4 templates)
70
+ - project-status, post-mortem, product-roadmap, qbr
71
+ - Category 7: Sales & Customer (2 templates)
72
+ - sales-playbook, customer-success
73
+ - Category 8: Learning & Collaboration (5 templates)
74
+ - training-material, workshop, interview-guide, joint-research-proposal, thinking-flow-report
75
+ - Japanese purpose keywords for each template
76
+ - Template Selection Flow with matching logic
77
+
8
78
  ## [1.44.0] - 2026-01-28
9
79
 
10
80
  ### Added
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nahisaho/shikigami",
3
- "version": "1.44.0",
3
+ "version": "1.48.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",