npx skills add ...
npx skills add daymade/claude-code-skills --skill deep-research
Generate format-controlled research reports with evidence tracking, citations, source governance, and multi-pass synthesis. This skill should be used when users request a research report, literature review, market or industry analysis, competitive landscape, policy or technical brief. Triggers: "帮我调研一下", "深度研究", "综述报告", "深入分析", "research this topic", "write a report on", "survey the literature on", "competitive analysis of", "技术选型分析", "竞品研究", "政策分析", "行业报告".
npx skills add daymade/claude-code-skills --skill deep-research
Create high-fidelity research reports with strict format control, evidence mapping, source governance, and multi-pass synthesis.
Context discipline: Keep raw search-result noise in task workspaces. Pass evidence packets to the lead agent, including locators and short source excerpts. Notes are routing aids, not authorities: the lead agent must open the original source for every load-bearing claim, conflicting claim, and exact figure/date/quotation used in the report.
Determine the research mode before starting:
| Dimension | Options |
|---|---|
| Topic Mode | Enterprise Research (company/corporation) OR General Research (industry/policy/tech) |
| Depth Mode | Standard (multiple decision questions or contested evidence) OR Lightweight (one bounded question with a small evidence surface) |
Classify every source by accessibility:
| Accessibility | Definition | Examples | Usage Rule |
|---|---|---|---|
public | Available to any external researcher without authentication | Public websites, news articles, WHOIS (without privacy), academic papers | ✅ Always allowed |
semi-public | Requires registration or limited access | LinkedIn profiles, Crunchbase basic, industry reports (free tier) | ✅ Allowed with disclosure |
exclusive-user-provided | User's paid subscriptions, private APIs, proprietary databases | Crunchbase Pro, PitchBook, private data feeds, internal databases | ✅ ALLOWED for third-party research |
authorized-first-party | User-authorized records about the user's own organization, transactions, or work | Contracts, invoices, CRM records, meeting transcripts | ✅ May establish internal business facts; label provenance |
First-party boundary: User-authorized records may establish what the organization did, agreed, paid, delivered, or observed. They do not count as independent external validation of market standing, customer sentiment, regulatory compliance, or third-party claims. Never relabel an internal record as an external finding.
✅ EXCLUSIVE INFORMATION ADVANTAGE: You SHOULD:
Every source MUST also be tagged with:
| Label | Definition | Examples |
|---|---|---|
official | Primary source, official documentation | Company SEC filings, government reports, official blog |
academic | Peer-reviewed research | Journal articles, conference papers, dissertations |
secondary-industry | Professional analysis | Industry reports, analyst coverage, trade publications |
journalism | News reporting | Reputable media outlets, investigative journalism |
community | User-generated content | Forums, reviews, social media, Q&A sites |
other | Uncategorized or mixed | Aggregators, unverified sources |
Coverage diagnostics: Track source counts, domains, source-type mix, and concentration to reveal thin coverage. Never pass or fail research from these totals alone. Gate on whether each decision question and load-bearing claim has fit-for-purpose evidence, whether counter-evidence was sought, and whether remaining unknowns are explicit.
Set AS_OF date explicitly at P0. For all time-sensitive claims:
Check capabilities before starting:
| Check | Requirement | Impact if Missing |
|---|---|---|
| Required evidence channel available | Required | Narrow scope or stop with the affected questions marked unknown |
| Original-source retrieval available | Required for load-bearing claims | Do not promote summaries/snippets to final evidence |
| Subagent dispatch | Preferred | Degrade to sequential |
| Filesystem writable | Required | In-memory notes only |
Set policy variables:
AS_OF: Today's date (YYYY-MM-DD) - mandatory for timed topicsMODE: Standard (default) or Lightweight, justified by the question mapSOURCE_TYPE_POLICY: Enforce official/academic/secondary/journalism/community/other labelsCOUNTER_REVIEW_PLAN: What evidence would overturn each provisional conclusionReport: [P0 complete] Subagent: {yes/no}. Mode: {standard/lightweight}. AS_OF: {YYYY-MM-DD}.
When researching a specific company, use the specialized workflow to route evidence by question. Treat the six dimensions as a coverage map, not a mandatory report outline.
Decompose the assignment into decision questions. Create tasks only where separate evidence routes or expertise make the work clearer.
Each task assignment includes:
When in Enterprise Research Mode, map questions to the relevant dimensions rather than creating all six tasks automatically:
Report: [P1 complete] {N} tasks in {M} groups. Dispatching Group A.
When researching a specific company, route each decision question through the relevant enterprise dimensions. Use the dimensions to find missing evidence paths; do not run all six or add quantified frameworks by default.
Same as P0/P1 above, plus:
Subagents execute tasks using references/subagent_prompt.md and output evidence packets in references/research_notes_format.md.
Source-Type and As OfEach task-{id}.md must contain:
Lead agent executes tasks sequentially, acting as each specialist. Preserve raw search noise outside the final evidence packet; retain a query log when reproducibility matters.
Follow references/enterprise_research_methodology.md for:
Key principles:
Run L1 quality check after completing each dimension (see enterprise_quality_checklist.md).
Status per task: [P2 task-{id} complete] {N} sources, {M} findings.
Status all: [P2 complete] {N} tasks done, {M} total sources. Building registry.
Load references/enterprise_analysis_frameworks.md only when the user's decision benefits from a framework. Use SWOT for strategic option framing, a risk matrix for decisions with explicit probability/impact inputs, and scoring only when weights and scales are defensible. Omit the framework rather than fabricate entries or precision.
Run L2 quality check after analysis is complete.
Three-level checks from references/enterprise_quality_checklist.md:
Use the 7-chapter enterprise report template from enterprise_quality_checklist.md only when it matches the requested decision. Otherwise adapt the structure around the question map.
Plus appendices: Data Source Index, Glossary, Disclaimer.
Lead agent reads all task notes and builds unified registry.
Critical rule: These [n] are FINAL. P5 may only cite from Approved list. Dropped sources never reappear.
Authorized first-party handling: When researching the user's own organization or assets:
authorized-first-party and state whose record it isExclusive source handling: When user EXPLICITLY PROVIDES their paid subscriptions or private APIs for third-party research (e.g., "Use my Crunchbase Pro to research competitors"), you SHOULD:
Report: [P3 complete] {answered}/{total} questions answered. {N} load-bearing claims supported, {M} unresolved. Source totals are diagnostics.
When researching entities with no public footprint:
What an external researcher would find:
Correct response:
DO NOT:
DO:
Lead agent reads evidence packets + registry to build the outline, then reopens decisive originals.
Outline format:
Write section by section using references/report_template_v6.md, adapting it to the user's format contract.
Rules:
Anti-hallucination:
Status: [P5 in progress] {N}/{M} sections, ~{words} words.
For each major conclusion, perform opposite-view checks. These checks do not automatically require another agent or a team; use independent reviewers only when the user request or applicable workspace instructions call for them:
For comprehensive parallel review, use the Counter-Review Team:
See references/counter_review_team_guide.md for detailed usage.
When a review team has not been selected, perform these evidence checks directly. Obtain individual independent review if the user request or applicable workspace instructions require it:
Include only evidence-backed controversies in the final report. Use numbered entries only when such controversies exist. If none are established, state that explicitly; never fill placeholder disputes to satisfy the template. Report unresolved uncertainty separately, or state that none remains.
The example above applies only when both statements are supported by the completed checks; otherwise list the actual controversies or unresolved questions.
Report: [P6 complete] {N} issues found: {critical} critical, {high} high, {medium} medium.
Cross-check before finalization:
Report: [P7 complete] {N} spot-checks, {M} violations fixed.
| File | When to Load |
|---|---|
| source_accessibility_policy.md | P0 (CRITICAL): Source classification rules - read first |
| subagent_prompt.md | P2: Task dispatch to subagents |
| research_notes_format.md | P2: Subagent output format |
| report_template_v6.md | P5: Draft with confidence markers and counter-review |
| quality_gates.md | All phases: Quality thresholds and anti-hallucination checks |
| File | When to Load |
|---|---|
| research_report_template.md | Build outline and draft structure |
| formatting_rules.md | Enforce section formatting and citation rules |
| source_quality_rubric.md | Score and triage sources |
| research_plan_checklist.md | Build research plan and query set |
| completeness_review_checklist.md | Review for coverage, citations, and compliance |
| File | When to Load |
|---|---|
| enterprise_research_methodology.md | Six-dimension data collection workflow, source priority, cross-validation rules |
| enterprise_analysis_frameworks.md | SWOT template, competitive barrier quantification, risk matrix, comprehensive scoring |
| enterprise_quality_checklist.md | L1/L2/L3 quality checks, per-dimension checklists, 7-chapter report template |
After completing research, suggest verification and output:
Enterprise Research Progress:
- [ ] E1: Intake — confirm company entity, research depth, format contract
- [ ] E2: Question-led evidence collection across relevant dimensions
- [ ] 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: Optional analysis framework selected for the decision (or none)
- [ ] E4: Claim/evidence/unknown checks at each stage transition
- [ ] E5: Draft in the user's requested structure
- [ ] E6: Multi-pass drafting + UNION merge (same as general Step 6-7)
- [ ] E7: Present draft for human review and iterateCITATION REGISTRY
Approved:
[1] Author/Org — Title | URL | Source-Type: official | Accessibility: public | Evidence-Family: filing-123 | Date: 2026-03-01 | task-a
[2] ...
Dropped:
x Source | URL | Source-Type: secondary-industry | Accessibility: public | Evidence-Family: unknown | Reason: original record could not be retrieved; summary cannot carry the claim
Diagnostics: {approved}/{total}, {N} domains, {N} independent evidence families, source-type mix
Coverage: {answered}/{total questions}; {N} load-bearing claims unresolvedFindings: NO PUBLIC INFORMATION AVAILABLE
Sources checked:
- WHOIS (public): Privacy protected [failed]
- Company registry (public): Access denied/No API [failed]
- News media: No coverage [failed]
- Corporate website: Placeholder only [minimal]
Verdict: UNABLE TO VERIFY COMPANY EXISTENCE from external perspective
Sources found: 0 (or minimal, e.g., only WHOIS showing domain exists)
Confidence: N/A - Insufficient evidence## N. {Section Title}
Sources: [1][3][7] from tasks a, b
Claims: {claim from task-a finding 3}, {claim from task-b finding 1}
Counter-claim candidates: {alternative explanations}
Recency checks: {source dates + AS_OF}
Gaps: {limited official evidence}# 1. Prepare inputs
counter-review-inputs/
├── draft_report.md
├── citation_registry.md
├── task-notes/
└── p0_config.md
# 2. Dispatch to 4 specialist agents in parallel
SendMessage to: claim-validator
SendMessage to: source-diversity-checker
SendMessage to: recency-validator
SendMessage to: contradiction-finder
# 3. Wait for all specialists to complete
# 4. Send to coordinator for synthesis
SendMessage to: counter-review-coordinator
inputs: [4 specialist reports]
# 5. Receive final P6 Counter-Review Report## 核心争议 / Key Controversies
未发现有证据支持的核心争议。
未解决的不确定性:无。Research report complete: [N] sources cited, [M] claims made.
Options:
A) Verify facts — run /fact-checker on the report (Recommended)
B) Create slides — pass the verified findings and citation registry to the active presentation workflow
C) Export as PDF — run /daymade-docs:pdf-creator for formal delivery
D) No thanks — the report is ready as-is