@michael-joseph-miller/ant-bot 0.1.0

package/skills/deep-research/references/counter_review_team_guide.md

@@ -0,0 +1,181 @@
+# Counter-Review Team 使用指南
+
+Deep Research V6 P6 阶段的专用 Agent Team，并行执行多维度审查。
+
+## Team 架构
+
+```
+counter-review-coordinator (协调者)
+    ├── claim-validator (声明验证器)
+    ├── source-diversity-checker (来源多样性检查器)
+    ├── recency-validator (时效性验证器)
+    └── contradiction-finder (矛盾发现器)
+```
+
+## Agent 职责
+
+| Agent | 职责 | 输出 |
+|-------|------|------|
+| **claim-validator** | 验证声明准确性，识别无证据/弱证据声明 | Claim Validation Report |
+| **source-diversity-checker** | 检查单一来源依赖，source-type 分布 | Source Diversity Report |
+| **recency-validator** | 验证时敏声明的新鲜度，AS_OF 合规 | Recency Validation Report |
+| **contradiction-finder** | 发现内部矛盾，缺失的反向观点 | Contradiction and Bias Report |
+| **counter-review-coordinator** | 整合所有报告，生成最终 P6 报告 | P6 Counter-Review Report |
+
+## 使用流程
+
+### 1. 准备输入材料
+
+在 P5 (Draft) 完成后，收集以下材料：
+
+```
+inputs/
+├── draft_report.md          # P5 起草的报告
+├── citation_registry.md     # P3 的引用注册表
+├── task-notes/
+│   ├── task-a.md           # 子代理研究笔记
+│   ├── task-b.md
+│   └── ...
+└── p0_config.md            # P0 配置 (AS_OF 日期, Mode 等)
+```
+
+### 2. 并行分发任务
+
+向 4 个 specialist agent 同时发送任务：
+
+```bash
+# 向 claim-validator 发送
+SendMessage to: claim-validator
+  输入: draft_report.md + citation_registry.md + task-notes/
+  指令: 验证所有声明的证据支持
+
+# 向 source-diversity-checker 发送
+SendMessage to: source-diversity-checker
+  输入: draft_report.md + citation_registry.md
+  指令: 检查来源多样性和单一来源依赖
+
+# 向 recency-validator 发送
+SendMessage to: recency-validator
+  输入: draft_report.md + citation_registry.md + p0_config.md
+  指令: 验证时敏声明的新鲜度
+
+# 向 contradiction-finder 发送
+SendMessage to: contradiction-finder
+  输入: draft_report.md + task-notes/ + citation_registry.md
+  指令: 发现矛盾和缺失的反向观点
+```
+
+### 3. 协调汇总
+
+等待 4 个 specialist 完成后，发送给 coordinator：
+
+```bash
+SendMessage to: counter-review-coordinator
+  输入:
+    - Claim Validation Report
+    - Source Diversity Report
+    - Recency Validation Report
+    - Contradiction and Bias Report
+  指令: 整合所有报告，生成最终 P6 Counter-Review Report
+```
+
+### 4. 获取最终输出
+
+Coordinator 输出包含：
+- 问题汇总（必须 ≥3 个）
+- 关键争议部分（可直接复制到最终报告）
+- 强制修复清单
+- 质量门状态
+
+## 质量门要求
+
+| 检查项 | 标准模式 | 轻量模式 | 失败处理 |
+|--------|---------|---------|---------|
+| 发现问题数 | ≥3 | ≥3 | 重新审查 |
+| 关键声明单来源 | 0 | 0 | 补充来源或降级 |
+| 官方来源占比 | ≥30% | ≥20% | 补充官方来源 |
+| AS_OF 日期完整 | 100% | 100% | 补充日期 |
+| 核心争议文档化 | 必填 | 必填 | 补充争议部分 |
+
+## 输出示例
+
+### Coordinator 最终报告结构
+
+```markdown
+# P6 Counter-Review Report
+
+## Executive Summary
+- Total issues found: 7 (critical: 2, high: 3, medium: 2)
+- Must-fix before publish: 2
+- Recommended improvements: 5
+
+## Critical Issues (Block Publish)
+| # | Issue | Location | Source | Fix Required |
+|---|-------|----------|--------|--------------|
+| 1 | 市场份额声明无来源 | 3.2节 | 无 | 补充来源或删除 |
+| 2 | 单一社区来源支持收入数据 | 4.1节 | [12] community | 找官方来源替代 |
+
+## 核心争议 / Key Controversies
+
+- **争议 1:** 公司声称增长 50% vs 分析师报告增长 30%
+  - 证据强度: official(公司财报) vs academic(第三方研究)
+  - 建议: 并列呈现两种数据，说明差异原因
+
+## Mandatory Fixes Checklist
+- [ ] 补充 3.2 节市场份额来源
+- [ ] 替换 4.1 节收入数据来源
+- [ ] 添加 AS_OF: 2026-04-03 到所有时敏声明
+
+## Quality Gates Status
+| Gate | Status | Notes |
+|------|--------|-------|
+| P6 ≥3 issues found | ✅ | 发现 7 个问题 |
+| No critical claim single-sourced | ❌ | 2 个问题待修复 |
+| AS_OF dates present | ❌ | 3 处缺失 |
+| Counter-claims documented | ✅ | 已添加 |
+```
+
+## 集成到 SKILL.md 工作流
+
+在 SKILL.md 的 P6 阶段，添加以下指令：
+
+```markdown
+## P6: Counter-Review (Mandatory)
+
+**使用 Counter-Review Team 执行并行审查：**
+
+1. **准备材料**: draft_report.md, citation_registry.md, task-notes/, p0_config.md
+2. **并行分发**: 同时发送给 4 个 specialist agent
+3. **等待完成**: 收集 4 份 specialist 报告
+4. **协调汇总**: 发送给 coordinator 生成最终 P6 报告
+5. **强制执行**: 所有 Critical 问题必须在 P7 前修复
+6. **输出**: 将"核心争议"部分复制到最终报告
+
+**Report**: `[P6 complete] {N} issues found: {critical} critical, {high} high, {medium} medium.`
+```
+
+## 团队管理
+
+### 查看团队状态
+```bash
+cat ~/.claude/teams/counter-review-team/config.json
+```
+
+### 向 Agent 发送消息
+```bash
+SendMessage to: claim-validator
+message: 开始审查任务，输入文件在 ./review-inputs/
+```
+
+### 关闭团队
+```bash
+SendMessage to: "*"
+message: {"type": "shutdown_request", "reason": "任务完成"}
+```
+
+## 注意事项
+
+1. **必须发现 ≥3 个问题** - 如果 coordinator 报告 <3 个问题，需要重新审查
+2. **Critical 问题必须修复** - 才能进入 P7
+3. **保留所有审查记录** - 作为研究方法论的一部分
+4. **中文输入中文输出** - 所有 agent 支持中英文双语

package/skills/deep-research/references/enterprise_analysis_frameworks.md

@@ -0,0 +1,135 @@
+# Enterprise Analysis Frameworks
+
+Apply these frameworks after completing the six-dimension data collection. Execute in order: SWOT → Competitive Barriers → Risk Matrix → Comprehensive Scoring.
+
+## SWOT Analysis Template
+
+Each SWOT entry MUST include evidence and source attribution.
+
+```
+|              | Positive Factors                  | Negative Factors                  |
+|--------------|-----------------------------------|-----------------------------------|
+| **Internal** | **S (Strengths)**                 | **W (Weaknesses)**                |
+|              | 1. {description}                  | 1. {description}                  |
+|              |    • Evidence: {data/fact}        |    • Evidence: {data/fact}        |
+|              |    • Source: {citation}           |    • Source: {citation}           |
+|              |    • Impact: {assessment}         |    • Impact: {assessment}         |
+|              |                                   |                                   |
+| **External** | **O (Opportunities)**             | **T (Threats)**                   |
+|              | 1. {description}                  | 1. {description}                  |
+|              |    • Evidence: {trend/policy}     |    • Evidence: {pressure/risk}    |
+|              |    • Source: {citation}           |    • Source: {citation}           |
+|              |    • Probability: {assessment}    |    • Probability: {assessment}    |
+|              |    • Impact: {assessment}         |    • Impact: {assessment}         |
+```
+
+**Requirements**:
+- Each quadrant: 3-5 entries minimum
+- Every entry must have evidence with source
+- S/W must be data-backed (not opinions)
+- O/T must include probability and impact estimates
+
+**Strategic Implications Matrix** (generate after SWOT):
+- **SO Strategy** (leverage strengths to capture opportunities): 1-2 specific recommendations
+- **WO Strategy** (overcome weaknesses to seize opportunities): 1-2 specific recommendations
+- **ST Strategy** (use strengths to counter threats): 1-2 specific recommendations
+- **WT Strategy** (mitigate weaknesses to avoid threats): 1-2 specific recommendations
+
+## Competitive Barrier Quantification Framework
+
+7 barrier dimensions with weighted scoring:
+
+| Dimension | Weight | Strong | Moderate | Weak |
+|-----------|--------|--------|----------|------|
+| **Network Effects** | 20% | 4.5 — Clear network effects (social platforms, marketplaces) | 3.0 — Exists but replaceable | 1.5 — Minimal network effects |
+| **Scale Economies** | 15% | 4.0 — Unit cost drops 30%+ with scale | 2.5 — Cost drops 10-30% | 1.0 — Cost drops <10% |
+| **Brand Value** | 15% | 4.0 — Category leader, high pricing power | 2.5 — Known brand, competitive | 1.0 — Commodity brand, price-sensitive |
+| **Technology/Patents** | 15% | 4.0 — Core patents, hard to circumvent | 2.5 — Some patent protection | 1.0 — Peripheral patents only |
+| **Switching Costs** | 15% | 4.0 — High lock-in (data, ecosystem) | 2.5 — Moderate switching friction | 1.0 — Low switching cost |
+| **Regulatory Licenses** | 10% | 3.5 — Heavy regulation, hard to obtain | 2.0 — Standard regulatory requirements | 0.5 — Light regulation |
+| **Data Assets** | 10% | 3.5 — Massive proprietary high-quality data | 2.0 — Some data accumulation | 0.5 — Limited or public data |
+
+**Scoring**: Total = Σ(dimension score × weight)
+
+**Rating Scale**:
+| Score | Rating | Interpretation |
+|-------|--------|---------------|
+| ≥3.5 | A+ | Exceptional moat |
+| ≥2.8 | A | Strong moat |
+| ≥2.0 | B+ | Good moat |
+| ≥1.5 | B | Moderate moat |
+| ≥1.0 | C+ | Limited moat |
+| <1.0 | C | Weak moat |
+
+**Output format**: Present a scorecard table with each dimension's strength rating, raw score, justification (with evidence), and the weighted total with final rating.
+
+## Risk Matrix Framework
+
+Assess 8 mandatory risk categories:
+
+### Risk Assessment Scales
+
+**Probability**:
+| Level | Range | Score |
+|-------|-------|-------|
+| High | >70% | 0.7-1.0 |
+| Medium | 30-70% | 0.3-0.7 |
+| Low | <30% | 0.0-0.3 |
+
+**Impact**:
+| Level | Description | Score |
+|-------|-------------|-------|
+| High | >30% revenue impact | 3 |
+| Medium | 10-30% revenue impact | 2 |
+| Low | <10% revenue impact | 1 |
+
+**Risk Level**: Risk Value = Probability Score × Impact Score
+| Color | Level | Threshold |
+|-------|-------|-----------|
+| Red | High risk | ≥2.5 |
+| Yellow | Medium risk | 1.0 – 2.5 |
+| Green | Low risk | <1.0 |
+
+### 8 Mandatory Risk Categories
+
+| # | Category | Typical Triggers |
+|---|----------|-----------------|
+| 1 | Market risk | Industry slowdown, demand shifts |
+| 2 | Competitive risk | New entrants, incumbents pivoting |
+| 3 | Technology risk | Tech obsolescence, disruption |
+| 4 | Regulatory risk | Policy tightening, compliance cost |
+| 5 | Financial risk | Cash flow stress, debt levels |
+| 6 | Operational risk | Key talent loss, supply chain |
+| 7 | Talent risk | Brain drain, recruiting difficulty |
+| 8 | Geopolitical risk | Trade friction, data localization |
+
+### Risk Table Format
+
+| Category | Specific Risk | Probability | Impact | Risk Value | Level | Evidence/Triggers | Current Mitigations | Recommended Actions |
+|----------|--------------|-------------|--------|------------|-------|-------------------|--------------------|--------------------|
+
+**Requirements**:
+- All 8 categories must be assessed (no skipping)
+- Each risk entry must cite specific evidence or triggers
+- Provide current mitigations AND recommended actions
+- High risks: require immediate action plans
+- Medium risks: require monitoring plans
+- Low risks: require periodic review schedule
+
+## Comprehensive Scoring (Final Section)
+
+After completing SWOT, barriers, and risk matrix, generate a comprehensive scorecard:
+
+```
+| Dimension | Score | Weight | Weighted | Key Evidence |
+|-----------|-------|--------|----------|-------------|
+| Business Quality | X/10 | 25% | | |
+| Competitive Position | X/10 | 20% | | |
+| Financial Health | X/10 | 20% | | |
+| Growth Potential | X/10 | 15% | | |
+| Risk Profile | X/10 | 10% | | |
+| Management Quality | X/10 | 10% | | |
+| **Total** | | 100% | **X/10** | |
+```
+
+Every score must reference specific evidence from the six-dimension data collection.

package/skills/deep-research/references/enterprise_mode.md

@@ -0,0 +1,99 @@
+# Enterprise Research Mode (Specialized Pipeline)
+
+Load this only when the topic is a specific company/corporation. It overlays the general
+P0-P7 pipeline in SKILL.md — it does not replace it. Everything not restated here (source
+governance, AS_OF policy, citation registry, counter-review, formatting) still applies.
+
+## Workflow overview
+
+```
+Enterprise Research Progress:
+- [ ] E1: Intake — confirm company entity, research depth, format contract
+- [ ] E2: Six-dimension data collection (parallel where possible)
+  - [ ] D1: Company fundamentals (entity, founding, funding, ownership)
+  - [ ] D2: Business & products (segments, products, revenue structure)
+  - [ ] D3: Competitive position (industry rank, competitors, barriers)
+  - [ ] D4: Financial & operations (3-year financials, efficiency metrics)
+  - [ ] D5: Recent developments (6-month events, strategic signals)
+  - [ ] D6: Internal/proprietary sources (or note limitation)
+- [ ] E3: Structured analysis frameworks
+  - [ ] SWOT analysis (evidence-backed, 4 quadrants × 3-5 entries)
+  - [ ] Competitive barrier quantification (7 dimensions, weighted score)
+  - [ ] Risk matrix (8 categories, probability × impact)
+  - [ ] Comprehensive scorecard (6 dimensions, weighted total)
+- [ ] E4: L1/L2/L3 quality checks at each stage transition
+- [ ] E5: Draft report using 7-chapter enterprise template
+- [ ] E6: Multi-pass drafting + UNION merge (same as general Step 6-7)
+- [ ] E7: Present draft for human review and iterate
+```
+
+## E1: Intake
+
+Same as P0/P1 in SKILL.md, plus:
+- Confirm the exact legal entity being researched (parent vs subsidiary)
+- Select research depth: Quick scan (3-5 pages) / Standard (10-20 pages) / Deep (20-40 pages)
+- Identify any specific comparison targets (benchmark companies)
+
+## E2: Six-dimension collection
+
+The P1 task board maps to the six dimensions:
+
+- Task A: Company fundamentals (entity, founding, funding, ownership)
+- Task B: Business & products (segments, products, revenue structure)
+- Task C: Competitive position (industry rank, competitors, barriers)
+- Task D: Financial & operations (3-year financials, efficiency metrics)
+- Task E: Recent developments (6-month events, strategic signals)
+- Task F: Internal/proprietary sources (or document limitation)
+
+Follow [enterprise_research_methodology.md](enterprise_research_methodology.md) for:
+- Detailed collection workflow per dimension (query strategies, data fields, validation)
+- Data source priority matrix (P0-P3 ranking)
+- Cross-validation rules (min sources, max deviation thresholds)
+
+**Key principles**:
+- Evidence-driven: every conclusion must trace to a citable source
+- Multi-source validation: key data requires ≥2 independent sources
+- Restrained judgment: mark speculation explicitly, avoid unsubstantiated claims
+- Structured presentation: complex information via tables, lists, hierarchies
+
+Run the L1 quality check after completing each dimension (see
+[enterprise_quality_checklist.md](enterprise_quality_checklist.md)).
+
+## E3: Structured analysis frameworks
+
+Apply frameworks from [enterprise_analysis_frameworks.md](enterprise_analysis_frameworks.md)
+in order:
+
+1. **SWOT analysis** — each entry with evidence + source + impact assessment
+2. **Competitive barrier quantification** — 7 dimensions with weighted scoring → A+/A/B+/B/C+/C rating
+3. **Risk matrix** — 8 mandatory categories, probability × impact → Red/Yellow/Green
+4. **Comprehensive scorecard** — 6-dimension weighted total → X/10
+
+Run the L2 quality check after analysis is complete.
+
+## E4: Quality control
+
+Three-level checks from [enterprise_quality_checklist.md](enterprise_quality_checklist.md):
+
+- **L1 (Data)**: Source count, attribution, cross-validation, timeliness
+- **L2 (Analysis)**: SWOT completeness, risk coverage, barrier scoring, conclusion support
+- **L3 (Document)**: Structure compliance, format consistency, readability, appendices
+
+## E5: Draft using the enterprise template
+
+Use the 7-chapter enterprise report template from
+[enterprise_quality_checklist.md](enterprise_quality_checklist.md):
+
+1. Company Overview
+2. Business & Product Structure
+3. Market & Competitive Position
+4. Financial & Operations Analysis
+5. Risks & Concerns
+6. Recent Developments
+7. Comprehensive Assessment & Conclusion
+
+Plus appendices: Data Source Index, Glossary, Disclaimer.
+
+## E6-E7: Multi-pass drafting and review
+
+Same as P4-P7 in SKILL.md.

package/skills/deep-research/references/enterprise_quality_checklist.md

@@ -0,0 +1,160 @@
+# Enterprise Research Quality Checklist
+
+Three-level quality control executed at each stage transition.
+
+## L1: Data Collection Quality (after each dimension)
+
+### Per-Dimension Checks
+
+| Check Item | Standard | Method | Pass Condition |
+|-----------|----------|--------|---------------|
+| Source count | Key data points ≥2 sources | Count source annotations | ≥90% compliance |
+| Source attribution | All data has source marked | Check citations in draft | ≥95% completeness |
+| Cross-validation pass rate | Data deviation ≤10% | Compare multi-source data | ≥95% validation pass |
+| Timeliness | Financial: ≤2 years; News: ≤6 months | Check timestamps | 100% compliance |
+
+**Result handling**: All pass → proceed. Partial fail → supplement sources. Critical fail → re-collect dimension.
+
+### Dimension-Specific Checklists
+
+**D1 Company Fundamentals** (target: 11/11):
+- [ ] Legal entity boundaries clarified
+- [ ] Founding date with month/year
+- [ ] Headquarters city identified
+- [ ] Founder/CEO confirmed (≥2 sources)
+- [ ] Employee count with year
+- [ ] Listing status (exchange, ticker)
+- [ ] Latest valuation/market cap with date
+- [ ] Core business one-liner
+- [ ] Funding history ≥3 rounds
+- [ ] ≥5 milestone events in timeline
+- [ ] Ownership structure: controller identified
+
+**D2 Business & Products** (target: 7/7):
+- [ ] ≥3 business segments identified
+- [ ] Revenue share per segment
+- [ ] ≥3 core products analyzed
+- [ ] User metrics (DAU/MAU) with numbers
+- [ ] Monetization model per product
+- [ ] Revenue breakdown (segment/geography/customer)
+- [ ] Growth/decline trend per segment
+
+**D3 Competitive Position** (target: 7/7):
+- [ ] Industry clearly defined
+- [ ] Market size quantified
+- [ ] Company rank established
+- [ ] Market share with number
+- [ ] ≥3 competitors identified
+- [ ] Multi-dimension comparison table complete
+- [ ] ≥5 barrier dimensions assessed with scores
+
+**D4 Financial & Operations** (target: 9/9):
+- [ ] Revenue: 3-year data
+- [ ] Net income: 3-year data
+- [ ] Gross margin: 3-year data
+- [ ] Net margin: 3-year data
+- [ ] Operating cash flow: 3-year data
+- [ ] R&D expense: 3-year data
+- [ ] Key financial data cross-validated (≥2 sources)
+- [ ] Metric definitions consistent across years
+- [ ] ≥3 efficiency metrics (ROE/ROA/etc.)
+
+**D5 Recent Developments** (target: 5/5):
+- [ ] ≥5 recent events (within 6 months)
+- [ ] Events span ≥3 event types
+- [ ] Each event has impact assessment
+- [ ] ≥2 strategic direction signals identified
+- [ ] Most recent event within 1 month
+
+**D6 Internal/Proprietary** (target: 2/2):
+- [ ] Internal knowledge base queried (or limitation noted)
+- [ ] Internal document search executed (or limitation noted)
+
+## L2: Analysis Quality (after analysis frameworks applied)
+
+| Check Item | Standard | Method | Pass Condition |
+|-----------|----------|--------|---------------|
+| SWOT completeness | Each quadrant ≥3 entries | Entry count | Full coverage |
+| SWOT evidence | Every entry has data backing | Check "Evidence" fields | 100% evidenced |
+| Risk matrix coverage | All 8 categories assessed | Category checklist | 100% covered |
+| Barrier quantification | All 7 dimensions scored | Check scorecard completeness | 100% scored |
+| Conclusion support | All conclusions trace to evidence | Trace each conclusion | 100% supported |
+
+**Result handling**: All pass → proceed to writing. Partial fail → supplement analysis evidence. Critical fail → re-execute analysis framework.
+
+## L3: Document Quality (after report drafted)
+
+| Check Item | Standard | Method | Pass Condition |
+|-----------|----------|--------|---------------|
+| Structure compliance | Follows 7-chapter template | Compare against template | ≥95% compliance |
+| Table format consistency | All tables uniformly formatted | Visual inspection | 100% uniform |
+| Readability | Paragraphs ≤450 chars; ≥3 parallel items use lists | Paragraph length check | ≥95% compliance |
+| Data annotation | All data has source + year | Citation audit | 100% complete |
+| Appendix completeness | Includes source index + glossary | Content check | 100% complete |
+
+**Result handling**: All pass → deliver. Partial fail → format optimization. Critical fail → regenerate document.
+
+## Enterprise Report Structure (7 Chapters)
+
+```
+# {Company Name} Research Report
+
+> Executive Summary: {1-2 sentence core conclusion}
+
+---
+
+## 1. Company Overview
+### 1.1 Basic Information (table)
+### 1.2 Development Timeline
+### 1.3 Funding History (table)
+### 1.4 Ownership Structure & Control
+### 1.5 Core Management Team (table)
+
+## 2. Business & Product Structure
+### 2.1 Business Landscape Overview
+### 2.2 Core Product Matrix (table)
+### 2.3 Revenue Structure Analysis
+### 2.4 Business Development Trends
+
+## 3. Market & Competitive Position
+### 3.1 Industry Position Analysis
+### 3.2 Competitive Comparison (table)
+### 3.3 Competitive Barrier Assessment (scorecard)
+
+## 4. Financial & Operations Analysis
+### 4.1 Key Financial Metrics (3-year comparison table)
+### 4.2 Operating Efficiency Assessment
+### 4.3 Financial Health Summary
+
+## 5. Risks & Concerns
+### 5.1 Risk Matrix Analysis (8-category table)
+### 5.2 Key Risk Deep-Dives
+### 5.3 Risk Mitigation Recommendations
+
+## 6. Recent Developments
+### 6.1 Major Recent Events (table)
+### 6.2 Strategic Signal Interpretation
+
+## 7. Comprehensive Assessment & Conclusion
+### 7.1 SWOT Summary
+### 7.2 Comprehensive Scorecard
+### 7.3 Core Conclusions & Outlook
+
+---
+
+## Appendices
+### A. Data Source Index
+### B. Glossary
+### C. Disclaimer
+```
+
+## Quality Control Four Dimensions
+
+Apply throughout all stages:
+
+| Dimension | Focus | Key Checks |
+|-----------|-------|------------|
+| **Accuracy** | Data correctness | Source attribution, fact verification, cross-validation, error tolerance |
+| **Completeness** | Information coverage | Dimension coverage, key element presence, conclusion support, risk coverage |
+| **Timeliness** | Data currency | Data freshness, trend capture, signal detection, dynamic updates |
+| **Consistency** | Uniform standards | Metric definitions aligned, format unified, style consistent, terminology standardized |