@nahisaho/shikigami 1.44.0 → 1.47.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 +166 -13
  2. package/CHANGELOG.md +55 -0
  3. package/package.json +1 -1
package/AGENTS.md CHANGED
@@ -313,7 +313,7 @@ When user says "project created", "created project", or similar:
313
313
  4. **(Phase 2)** **Purpose Discovery** → Discover true purpose through 1Q1A dialogue
314
314
  5. **(Phase 3)** **Deep Research** → Think→Search→Report→Action cycle
315
315
  6. **(Phase 4)** **Framework Analysis** → Apply SWOT/3C/PEST etc.
316
- 7. **(Phase 5)** **Report Generation** → Create structured report
316
+ 7. **(Phase 5)** **Report Generation** → Select template → Write report → Quality check → **WAIT for approval**
317
317
  8. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
318
318
 
319
319
  ### Case B: New research request (no project yet)
@@ -329,12 +329,13 @@ When receiving a new research request:
329
329
  7. **(Phase 2)** **Purpose Discovery** → Discover true purpose through 1Q1A dialogue
330
330
  8. **(Phase 3)** **Deep Research** → Think→Search→Report→Action cycle
331
331
  9. **(Phase 4)** **Framework Analysis** → Apply SWOT/3C/PEST etc.
332
- 10. **(Phase 5)** **Report Generation** → Create structured report
332
+ 10. **(Phase 5)** **Report Generation** → Select template → Write report → Quality check → **WAIT for approval**
333
333
  11. **(Phase 6)** **Complete** → Update manifest.yaml, verify deliverables
334
334
 
335
335
  **MANDATORY APPROVAL POINTS** (must wait for user before proceeding):
336
336
  - Case B Step 1: Project name confirmation
337
337
  - Phase 1 (both cases): Structured prompt approval
338
+ - Phase 5→6 (both cases): Quality check approval
338
339
 
339
340
  ---
340
341
 
@@ -545,16 +546,85 @@ OUTPUT: Completed report (under reports/), reference list
545
546
  ```
546
547
 
547
548
  **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 |
549
+
550
+ **Category 1: Approval & Decision**
551
+ | Purpose Keywords | Template | Use When |
552
+ |------------------|----------|----------|
553
+ | 予算承認、投資申請、コスト承認 | budget-approval | Budget/investment approval requests |
554
+ | 即時承認、緊急承認、迅速決定 | immediate-approval | Time-sensitive approvals |
555
+ | 段階承認、フェーズ承認、マイルストーン | staged-approval | Multi-phase approval processes |
556
+ | パイロット、試験導入、PoC承認 | pilot-approval | Pilot/trial approvals |
557
+ | 変更要求、変更管理、スコープ変更 | change-request | Change requests, scope changes |
558
+
559
+ **Category 2: Analysis & Research**
560
+ | Purpose Keywords | Template | Use When |
561
+ |------------------|----------|----------|
562
+ | 市場調査、市場分析、マーケット | market-analysis | Market research, industry analysis |
563
+ | 競合分析、競合調査、ライバル | competitive-analysis | Competitor landscape analysis |
564
+ | ユーザー調査、UXリサーチ、顧客理解 | user-research | User/customer research |
565
+ | リスク評価、リスク分析、脆弱性 | risk-assessment | Risk assessment, vulnerability analysis |
566
+ | デューデリジェンス、M&A、投資判断 | due-diligence | Due diligence, M&A evaluation |
567
+ | ABテスト、実験結果、比較実験 | ab-test | A/B test results, experiment reports |
568
+
569
+ **Category 3: Vendor & Procurement**
570
+ | Purpose Keywords | Template | Use When |
571
+ |------------------|----------|----------|
572
+ | ベンダー評価、製品選定、ツール選定 | vendor-evaluation | Vendor/product evaluation |
573
+ | RFI、情報提供依頼、事前調査 | rfi | Request for Information |
574
+ | RFP、提案依頼、入札 | rfp | Request for Proposal |
575
+ | SLA、サービスレベル、契約条件 | sla | SLA definition, service contracts |
576
+
577
+ **Category 4: Technical & Security**
578
+ | Purpose Keywords | Template | Use When |
579
+ |------------------|----------|----------|
580
+ | 技術調査、技術評価、アーキテクチャ | technical-report | Deep technical investigation |
581
+ | セキュリティ評価、脆弱性診断、監査 | security-assessment | Security audits, assessments |
582
+ | コンプライアンス、規制対応、法令遵守 | compliance | Compliance reports, regulatory |
583
+
584
+ **Category 5: Business & Strategy**
585
+ | Purpose Keywords | Template | Use When |
586
+ |------------------|----------|----------|
587
+ | ビジネスケース、投資対効果、ROI | business-case | Business case, ROI analysis |
588
+ | エグゼクティブサマリー、経営報告 | executive-summary | Brief overview for executives |
589
+ | ホワイトペーパー、技術解説、啓蒙 | white-paper | Thought leadership, technical papers |
590
+ | 検討資料、比較検討、オプション分析 | consideration | Options analysis, consideration docs |
591
+
592
+ **Category 6: Project & Operations**
593
+ | Purpose Keywords | Template | Use When |
594
+ |------------------|----------|----------|
595
+ | プロジェクト状況、進捗報告、ステータス | project-status | Project status reports |
596
+ | ポストモーテム、振り返り、障害報告 | post-mortem | Incident reviews, retrospectives |
597
+ | ロードマップ、製品計画、開発計画 | product-roadmap | Product/development roadmaps |
598
+ | QBR、四半期レビュー、業績報告 | qbr | Quarterly business reviews |
599
+
600
+ **Category 7: Sales & Customer**
601
+ | Purpose Keywords | Template | Use When |
602
+ |------------------|----------|----------|
603
+ | 営業資料、セールス、提案書 | sales-playbook | Sales enablement materials |
604
+ | 顧客成功事例、ケーススタディ、導入事例 | customer-success | Customer success stories |
605
+
606
+ **Category 8: Learning & Collaboration**
607
+ | Purpose Keywords | Template | Use When |
608
+ |------------------|----------|----------|
609
+ | 研修資料、トレーニング、教育 | training-material | Training/education materials |
610
+ | ワークショップ、ファシリテーション | workshop | Workshop design, facilitation |
611
+ | インタビューガイド、ヒアリング | interview-guide | Interview/hearing guides |
612
+ | 共同研究、産学連携、研究提案 | joint-research-proposal | Joint research proposals |
613
+ | 思考フロー、分析過程、ロジック展開 | thinking-flow-report | Thinking process documentation |
614
+
615
+ **Template Selection Flow**:
616
+ ```
617
+ WHEN: Phase 5 starts
618
+ DO:
619
+ 1. Extract purpose keywords from user's original request
620
+ 2. Match keywords against Template Selection Criteria tables
621
+ 3. If multiple matches, prioritize by:
622
+ a. Exact keyword match
623
+ b. Category relevance
624
+ c. User's stated output format
625
+ 4. If no match found, use 'consideration' as default
626
+ 5. Confirm template selection with user before writing
627
+ ```
558
628
 
559
629
  **CRITICAL**: Always use `shikigami-report-template` skill to load the appropriate template BEFORE writing. Template provides:
560
630
  - Required sections and structure
@@ -611,6 +681,89 @@ OUTPUT: Completed report (under reports/), reference list
611
681
  | 4→5 | 1+ framework applied, numerical verification done | Not required |
612
682
  | 5→6 | Report exists, quality check passed, citations complete | **Required** |
613
683
 
684
+ ### Quality Checklist (Phase 5→6 Gate)
685
+
686
+ ```
687
+ WHEN: Report draft completed, before Phase 6
688
+ DO: Execute ALL checks below. Report CANNOT proceed to Phase 6 until all items pass.
689
+ ```
690
+
691
+ **1. Numerical Consistency Check** ✅
692
+ | Check Item | How to Verify | FAIL Condition |
693
+ |------------|---------------|----------------|
694
+ | Source attribution | Every number has [[n]] citation | Any number without citation |
695
+ | Percentage totals | Sum of percentages = 100% (or explicitly explained) | Silent deviation from 100% |
696
+ | Text-table match | Numbers in body text match tables/charts | Any discrepancy |
697
+ | Unit correctness | 億/万/thousand/million used correctly | Unit mismatch or confusion |
698
+ | Time series order | Chronological data in correct sequence | Year/date ordering errors |
699
+ | Calculation accuracy | Derived numbers (growth rate, averages) are correct | Math errors |
700
+
701
+ **2. Citation Completeness Check** 📚
702
+ | Check Item | How to Verify | FAIL Condition |
703
+ |------------|---------------|----------------|
704
+ | Inline citations | All facts/claims have [[n]] format | Uncited factual statements |
705
+ | References list | All [[n]] appear in References section | Missing reference entries |
706
+ | URL validity | All URLs are accessible | 404 or dead links |
707
+ | No vague sources | No "various sources", "it is said that" | Vague attributions |
708
+ | Date recorded | All references include access date | Missing dates |
709
+
710
+ **3. Content Consistency Check** 🔄
711
+ | Check Item | How to Verify | FAIL Condition |
712
+ |------------|---------------|----------------|
713
+ | Executive summary sync | Summary numbers match body text | Any discrepancy |
714
+ | Conclusion alignment | Conclusions supported by analysis | Unsupported claims |
715
+ | Conflict markers handled | All (?), (⚡), (💭) items addressed | Unresolved conflicts |
716
+ | MECE coverage | No gaps or overlaps in analysis | Logical gaps |
717
+
718
+ **4. Format & Structure Check** 📋
719
+ | Check Item | How to Verify | FAIL Condition |
720
+ |------------|---------------|----------------|
721
+ | Template compliance | All required sections present | Missing sections |
722
+ | Heading hierarchy | Proper H1→H2→H3 structure | Broken hierarchy |
723
+ | Table formatting | Tables render correctly | Malformed tables |
724
+ | Link formatting | All links work correctly | Broken markdown links |
725
+
726
+ **Quality Check Execution Flow**:
727
+ ```
728
+ Phase 5 Complete
729
+
730
+ [1] Run Numerical Consistency Check
731
+ ↓ (All pass?)
732
+ [2] Run Citation Completeness Check
733
+ ↓ (All pass?)
734
+ [3] Run Content Consistency Check
735
+ ↓ (All pass?)
736
+ [4] Run Format & Structure Check
737
+ ↓ (All pass?)
738
+ Generate Quality Report Summary
739
+
740
+ Request User Approval for Phase 6
741
+ ```
742
+
743
+ **Quality Report Format**:
744
+ ```markdown
745
+ ## Quality Check Results
746
+
747
+ | Category | Status | Issues Found |
748
+ |----------|--------|-------------|
749
+ | Numerical Consistency | ✅ PASS / ❌ FAIL | [count] issues |
750
+ | Citation Completeness | ✅ PASS / ❌ FAIL | [count] issues |
751
+ | Content Consistency | ✅ PASS / ❌ FAIL | [count] issues |
752
+ | Format & Structure | ✅ PASS / ❌ FAIL | [count] issues |
753
+
754
+ ### Issues to Address (if any)
755
+ 1. [Issue description and location]
756
+ 2. [Issue description and location]
757
+ ```
758
+
759
+ **Auto-Fix Rules**:
760
+ | Issue Type | Auto-Fix Action |
761
+ |------------|----------------|
762
+ | Missing citation | Flag with ⚠️, request source |
763
+ | Percentage ≠ 100% | Add "(その他: X%)" or note |
764
+ | Unit confusion | Standardize to larger unit |
765
+ | Dead URL | Attempt Wayback Machine recovery |
766
+
614
767
  ---
615
768
 
616
769
  ## File Saving Rules
@@ -871,4 +1024,4 @@ DO: Auto-detect Shift_JIS/EUC-JP/ISO-2022-JP and convert to UTF-8
871
1024
  ---
872
1025
 
873
1026
  **Last Updated**: 2026-01-28
874
- **Version**: 1.44.0
1027
+ **Version**: 1.47.0
package/CHANGELOG.md CHANGED
@@ -5,6 +5,61 @@ 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.47.0] - 2026-01-28
9
+
10
+ ### Changed
11
+
12
+ - **AGENTS.md: Integrate template selection & quality check into workflow overview**
13
+ - Case A Phase 5: "Create structured report" → "Select template → Write report → Quality check → **WAIT for approval**"
14
+ - Case B Phase 5: Same update
15
+ - Added Phase 5→6 to MANDATORY APPROVAL POINTS
16
+ - Quality check approval now required before Phase 6
17
+
18
+ ## [1.46.0] - 2026-01-28
19
+
20
+ ### Added
21
+
22
+ - **AGENTS.md: Detailed Quality Checklist (Phase 5→6 Gate)**
23
+ - **Numerical Consistency Check**: 6 items
24
+ - Source attribution, percentage totals, text-table match
25
+ - Unit correctness, time series order, calculation accuracy
26
+ - **Citation Completeness Check**: 5 items
27
+ - Inline citations, references list, URL validity
28
+ - No vague sources, date recorded
29
+ - **Content Consistency Check**: 4 items
30
+ - Executive summary sync, conclusion alignment
31
+ - Conflict markers handled, MECE coverage
32
+ - **Format & Structure Check**: 4 items
33
+ - Template compliance, heading hierarchy
34
+ - Table formatting, link formatting
35
+ - Quality Check Execution Flow diagram
36
+ - Quality Report Format template
37
+ - Auto-Fix Rules for common issues
38
+
39
+ ## [1.45.0] - 2026-01-28
40
+
41
+ ### Added
42
+
43
+ - **AGENTS.md: Complete Template Selection Criteria (33 templates)**
44
+ - Category 1: Approval & Decision (5 templates)
45
+ - budget-approval, immediate-approval, staged-approval, pilot-approval, change-request
46
+ - Category 2: Analysis & Research (6 templates)
47
+ - market-analysis, competitive-analysis, user-research, risk-assessment, due-diligence, ab-test
48
+ - Category 3: Vendor & Procurement (4 templates)
49
+ - vendor-evaluation, rfi, rfp, sla
50
+ - Category 4: Technical & Security (3 templates)
51
+ - technical-report, security-assessment, compliance
52
+ - Category 5: Business & Strategy (4 templates)
53
+ - business-case, executive-summary, white-paper, consideration
54
+ - Category 6: Project & Operations (4 templates)
55
+ - project-status, post-mortem, product-roadmap, qbr
56
+ - Category 7: Sales & Customer (2 templates)
57
+ - sales-playbook, customer-success
58
+ - Category 8: Learning & Collaboration (5 templates)
59
+ - training-material, workshop, interview-guide, joint-research-proposal, thinking-flow-report
60
+ - Japanese purpose keywords for each template
61
+ - Template Selection Flow with matching logic
62
+
8
63
  ## [1.44.0] - 2026-01-28
9
64
 
10
65
  ### Added
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nahisaho/shikigami",
3
- "version": "1.44.0",
3
+ "version": "1.47.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",