@nahisaho/shikigami 1.41.0 → 1.44.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.
- package/AGENTS.md +168 -12
- package/CHANGELOG.md +41 -0
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -32,7 +32,7 @@ VIOLATION = WORKFLOW FAILURE
|
|
|
32
32
|
|
|
33
33
|
| Item | Value |
|
|
34
34
|
|------|-------|
|
|
35
|
-
| Version | 1.
|
|
35
|
+
| Version | 1.42.0 |
|
|
36
36
|
| Agent Skills | 4 |
|
|
37
37
|
| MCP Tools | 11 |
|
|
38
38
|
| Frameworks | 53 |
|
|
@@ -146,14 +146,53 @@ FORBIDDEN: Web search, using search tools, or gathering information before proje
|
|
|
146
146
|
|
|
147
147
|
### Prohibition 3: save_research Required After search/visit
|
|
148
148
|
|
|
149
|
+
**🚨🚨🚨 EVERY search/visit MUST be followed by save_research 🚨🚨🚨**
|
|
150
|
+
|
|
149
151
|
```
|
|
150
152
|
WHEN: Executed search or visit MCP tool
|
|
151
|
-
DO: IMMEDIATELY call save_research MCP tool (within the
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
153
|
+
DO: IMMEDIATELY call save_research MCP tool (within the SAME response, not later)
|
|
154
|
+
|
|
155
|
+
MANDATORY PATTERN - NO EXCEPTIONS:
|
|
156
|
+
search(...) → save_research(...) → next action
|
|
157
|
+
visit(...) → save_research(...) → next action
|
|
158
|
+
|
|
159
|
+
EXAMPLE 1 (Search):
|
|
160
|
+
1. search(query: ["AI市場動向", "AI market trends"])
|
|
161
|
+
2. save_research(
|
|
162
|
+
content: "<検索結果の全文をここに>",
|
|
163
|
+
source: "search",
|
|
164
|
+
query: "AI市場動向"
|
|
165
|
+
)
|
|
166
|
+
|
|
167
|
+
EXAMPLE 2 (Visit):
|
|
168
|
+
1. visit(url: "https://example.com/article")
|
|
169
|
+
2. save_research(
|
|
170
|
+
content: "<ページ内容の全文をここに>",
|
|
171
|
+
source: "visit",
|
|
172
|
+
query: "https://example.com/article"
|
|
173
|
+
)
|
|
174
|
+
|
|
175
|
+
FORBIDDEN (IMMEDIATE VIOLATION):
|
|
176
|
+
- Calling search then another search without save_research in between
|
|
177
|
+
- Calling visit then summarizing without save_research first
|
|
178
|
+
- Proceeding to analysis without saving raw data
|
|
179
|
+
- "I'll save it later" - NO! Save IMMEDIATELY
|
|
180
|
+
|
|
181
|
+
CONSEQUENCE: Research data will be lost, workflow corrupted, unable to cite sources
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
**CORRECT FLOW**:
|
|
185
|
+
```
|
|
186
|
+
Agent: search(query: [...])
|
|
187
|
+
→ [結果を受信]
|
|
188
|
+
→ save_research(content: <全結果>, source: "search", query: <query>)
|
|
189
|
+
→ "検索結果を保存しました。次に..."
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
**INCORRECT FLOW (VIOLATION)**:
|
|
193
|
+
```
|
|
194
|
+
Agent: search(query: [...])
|
|
195
|
+
→ "検索結果によると..." ← ❌ save_research を呼んでいない!
|
|
157
196
|
```
|
|
158
197
|
|
|
159
198
|
### Prohibition 4: save_prompt Required After User Input
|
|
@@ -335,7 +374,7 @@ NEXT: Phase 1 (Prompt Optimization) - NOT Phase 3 (Search)
|
|
|
335
374
|
|
|
336
375
|
### Phase 1: Prompt Optimization
|
|
337
376
|
|
|
338
|
-
|
|
377
|
+
** THIS PHASE IS MANDATORY - NEVER SKIP **
|
|
339
378
|
|
|
340
379
|
```
|
|
341
380
|
WHEN: Phase 0 completed (project created and set_project called)
|
|
@@ -423,15 +462,34 @@ DO:
|
|
|
423
462
|
LOOP:
|
|
424
463
|
1. Think: Analyze knowledge gaps
|
|
425
464
|
2. Search: search(query: ["Japanese query", "English query"])
|
|
426
|
-
3. IMMEDIATELY: save_research(content: <search_results>, source: "search", query: <query>)
|
|
465
|
+
3. 🚨 IMMEDIATELY: save_research(content: <FULL search_results>, source: "search", query: <query>)
|
|
466
|
+
→ Do NOT proceed without this step!
|
|
427
467
|
4. Visit: visit(url: <target_url>)
|
|
428
|
-
5. IMMEDIATELY: save_research(content: <page_content>, source: "visit", query: <url>)
|
|
468
|
+
5. 🚨 IMMEDIATELY: save_research(content: <FULL page_content>, source: "visit", query: <url>)
|
|
469
|
+
→ Do NOT proceed without this step!
|
|
429
470
|
6. Report: Organize collected information
|
|
430
471
|
7. Action: Determine if additional search needed
|
|
431
472
|
OUTPUT: Collected information summary, source list (URL + credibility)
|
|
432
473
|
```
|
|
433
474
|
|
|
434
|
-
|
|
475
|
+
**🚨 CRITICAL - save_research is MANDATORY after EVERY search/visit**:
|
|
476
|
+
- Steps 3 and 5 are NOT optional
|
|
477
|
+
- You MUST call save_research IMMEDIATELY after each search/visit
|
|
478
|
+
- Do NOT analyze or summarize before saving raw data
|
|
479
|
+
- Do NOT call multiple searches without saving each one
|
|
480
|
+
|
|
481
|
+
**CORRECT Phase 3 Flow**:
|
|
482
|
+
```
|
|
483
|
+
search(query: [...])
|
|
484
|
+
↓
|
|
485
|
+
save_research(content: <全結果>, source: "search", ...) ← 必須!
|
|
486
|
+
↓
|
|
487
|
+
visit(url: ...)
|
|
488
|
+
↓
|
|
489
|
+
save_research(content: <全内容>, source: "visit", ...) ← 必須!
|
|
490
|
+
↓
|
|
491
|
+
[分析・次のアクション]
|
|
492
|
+
```
|
|
435
493
|
|
|
436
494
|
**Search Rules**:
|
|
437
495
|
- Parallel JP/EN search required: `["Japanese query", "English query"]`
|
|
@@ -663,6 +721,104 @@ projects/pjXXXXX_Name_YYYYMMDD/
|
|
|
663
721
|
|
|
664
722
|
---
|
|
665
723
|
|
|
724
|
+
## Information Conflict Handling
|
|
725
|
+
|
|
726
|
+
```
|
|
727
|
+
WHEN: Multiple sources provide conflicting information on the same fact
|
|
728
|
+
DO:
|
|
729
|
+
1. Mark the fact with "(?)" in the report
|
|
730
|
+
2. Note all conflicting values with their sources
|
|
731
|
+
3. Identify the most credible source based on Credibility Scoring
|
|
732
|
+
4. Add conflicting facts to "Information Conflicts" section at report end
|
|
733
|
+
```
|
|
734
|
+
|
|
735
|
+
**Conflict Notation Format**:
|
|
736
|
+
```
|
|
737
|
+
[Fact]: [Value](?)
|
|
738
|
+
- Source A ([Name]): [Value A]
|
|
739
|
+
- Source B ([Name]): [Value B]
|
|
740
|
+
- Source C ([Name]): [Value C]
|
|
741
|
+
→ Most credible: [Source] ([Reason])
|
|
742
|
+
```
|
|
743
|
+
|
|
744
|
+
**Example**:
|
|
745
|
+
```
|
|
746
|
+
市場規模: 500億円(?)
|
|
747
|
+
- Source A (日経新聞): 500億円
|
|
748
|
+
- Source B (業界団体レポート): 480億円
|
|
749
|
+
- Source C (調査会社X): 520億円
|
|
750
|
+
→ Most credible: 日経新聞 (Major media, published 2025-12)
|
|
751
|
+
```
|
|
752
|
+
|
|
753
|
+
**Report Section Template**:
|
|
754
|
+
```markdown
|
|
755
|
+
## Information Conflicts
|
|
756
|
+
|
|
757
|
+
| Fact | Values | Most Credible | Reason |
|
|
758
|
+
|------|--------|---------------|--------|
|
|
759
|
+
| 市場規模 | 480-520億円 | 500億円 (日経) | Major media, latest data |
|
|
760
|
+
| 成長率 | 3.2%-4.1% | 3.5% (業界団体) | Primary source |
|
|
761
|
+
```
|
|
762
|
+
|
|
763
|
+
**Conflict Severity Levels**:
|
|
764
|
+
| Deviation | Severity | Action |
|
|
765
|
+
|-----------|----------|--------|
|
|
766
|
+
| <5% | Low | Note in footnote |
|
|
767
|
+
| 5-20% | Medium | Mark with (?), add to Conflicts section |
|
|
768
|
+
| >20% | High | Mark with (??), investigate further, consider excluding unreliable sources |
|
|
769
|
+
|
|
770
|
+
### Content/Opinion Conflicts
|
|
771
|
+
|
|
772
|
+
```
|
|
773
|
+
WHEN: Sources provide contradictory statements or opinions on the same topic
|
|
774
|
+
DO:
|
|
775
|
+
1. Mark with "(⚡)" for factual contradictions
|
|
776
|
+
2. Mark with "(💭)" for opinion/interpretation differences
|
|
777
|
+
3. Present all viewpoints with their sources
|
|
778
|
+
4. Add to "Content Conflicts" section at report end
|
|
779
|
+
```
|
|
780
|
+
|
|
781
|
+
**Conflict Type Markers**:
|
|
782
|
+
| Marker | Type | Description |
|
|
783
|
+
|--------|------|-------------|
|
|
784
|
+
| (?) | Numeric | Values differ by 5-20% |
|
|
785
|
+
| (??) | Numeric (High) | Values differ by >20% |
|
|
786
|
+
| (⚡) | Factual | Contradictory facts/statements |
|
|
787
|
+
| (💭) | Opinion | Different interpretations/predictions |
|
|
788
|
+
|
|
789
|
+
**Example (Factual Contradiction)**:
|
|
790
|
+
```
|
|
791
|
+
原因(⚡):
|
|
792
|
+
- Source A (調査報告書): 「システム障害が主因」
|
|
793
|
+
- Source B (業界紙): 「人的ミスが主因」
|
|
794
|
+
→ No consensus - both viewpoints presented
|
|
795
|
+
```
|
|
796
|
+
|
|
797
|
+
**Example (Opinion/Interpretation Difference)**:
|
|
798
|
+
```
|
|
799
|
+
将来予測(💭):
|
|
800
|
+
- Source A (アナリストX): 「市場は2030年まで拡大する」
|
|
801
|
+
- Source B (業界団体): 「市場は縮小傾向にある」
|
|
802
|
+
→ Different interpretations noted - reader should evaluate
|
|
803
|
+
```
|
|
804
|
+
|
|
805
|
+
**Content Conflicts Section Template**:
|
|
806
|
+
```markdown
|
|
807
|
+
## Content Conflicts
|
|
808
|
+
|
|
809
|
+
### Factual Contradictions (⚡)
|
|
810
|
+
| Topic | Viewpoint A | Viewpoint B | Sources |
|
|
811
|
+
|-------|-------------|-------------|----------|
|
|
812
|
+
| 障害原因 | システム障害 | 人的ミス | 調査報告書 vs 業界紙 |
|
|
813
|
+
|
|
814
|
+
### Opinion Differences (💭)
|
|
815
|
+
| Topic | Viewpoint A | Viewpoint B | Sources |
|
|
816
|
+
|-------|-------------|-------------|----------|
|
|
817
|
+
| 市場予測 | 拡大継続 | 縮小傾向 | アナリストX vs 業界団体 |
|
|
818
|
+
```
|
|
819
|
+
|
|
820
|
+
---
|
|
821
|
+
|
|
666
822
|
## Academic Search Rules
|
|
667
823
|
|
|
668
824
|
```
|
|
@@ -715,4 +871,4 @@ DO: Auto-detect Shift_JIS/EUC-JP/ISO-2022-JP and convert to UTF-8
|
|
|
715
871
|
---
|
|
716
872
|
|
|
717
873
|
**Last Updated**: 2026-01-28
|
|
718
|
-
**Version**: 1.
|
|
874
|
+
**Version**: 1.44.0
|
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,47 @@ 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.44.0] - 2026-01-28
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
- **AGENTS.md: Content/Opinion Conflict Handling**
|
|
13
|
+
- New markers for non-numeric conflicts:
|
|
14
|
+
- `(⚡)` for factual contradictions (e.g., different causes stated)
|
|
15
|
+
- `(💭)` for opinion/interpretation differences (e.g., predictions)
|
|
16
|
+
- Unified Conflict Type Markers table: (?), (??), (⚡), (💭)
|
|
17
|
+
- Content Conflicts section template with Factual/Opinion subsections
|
|
18
|
+
- Examples for both factual contradictions and opinion differences
|
|
19
|
+
|
|
20
|
+
## [1.43.0] - 2026-01-28
|
|
21
|
+
|
|
22
|
+
### Added
|
|
23
|
+
|
|
24
|
+
- **AGENTS.md: Information Conflict Handling**
|
|
25
|
+
- New section for handling conflicting information across sources
|
|
26
|
+
- Mark facts with "(?)\" when sources disagree
|
|
27
|
+
- Conflict notation format with source comparison
|
|
28
|
+
- "Information Conflicts" table template for reports
|
|
29
|
+
- Conflict severity levels: Low (<5%), Medium (5-20%), High (>20%)
|
|
30
|
+
- High severity "(??)" marking for >20% deviations
|
|
31
|
+
|
|
32
|
+
## [1.42.0] - 2026-01-28
|
|
33
|
+
|
|
34
|
+
### Added
|
|
35
|
+
|
|
36
|
+
- **AGENTS.md: Enforce save_research after every search/visit**
|
|
37
|
+
- Prohibition 3: Added 🚨🚨🚨 warning header
|
|
38
|
+
- Added MANDATORY PATTERN section with clear flow
|
|
39
|
+
- Added detailed EXAMPLE 1 (Search) and EXAMPLE 2 (Visit) with full parameters
|
|
40
|
+
- Added CORRECT/INCORRECT flow examples
|
|
41
|
+
- Added explicit prohibition against "I'll save it later"
|
|
42
|
+
|
|
43
|
+
- **AGENTS.md: Phase 3 save_research enforcement**
|
|
44
|
+
- Added 🚨 markers to steps 3 and 5
|
|
45
|
+
- Added "Do NOT proceed without this step!" warnings
|
|
46
|
+
- Added CORRECT Phase 3 Flow diagram
|
|
47
|
+
- Expanded CRITICAL section with specific prohibitions
|
|
48
|
+
|
|
8
49
|
## [1.41.0] - 2026-01-28
|
|
9
50
|
|
|
10
51
|
### Added
|
package/package.json
CHANGED