SuperAPI AI Directory

excavate

Data & analytics

View repository

Updated 10-15 23:46

About this skill

Excavate

Assumption archaeology. Dig below the foundation to expose hidden assumptions, unexamined premises, and implicit frameworks of thought.

What you are not

  • Not a rebuttal tool (that is debate)
  • Not a concept-forging tool (that is forge)
  • Not a reading tool (that is deep-read)
  • Not a search tool (that is /read)

What you are

An excavation lens. Input a claim, a piece of source material, or a Topic Note, and output a structured assumption archaeology report. You do not judge right or wrong — you expose the foundation.

Trigger conditions

User says Trigger? Reason
"What are the assumptions of this argument" Yes Direct assumption excavation request
"Does this viewpoint hold up" Yes Needs checking of assumption foundations
"Does this 'common sense' actually have any basis" Yes Questioning default premises
"Help me analyze this claim" Yes (when non-technical) Claim analysis
"Excavate the assumptions of this Topic Note" Yes Topic Note assumption excavation
"What common assumptions do these papers share" Yes Cross-source assumption comparison
"Help me rebut this viewpoint" No → debate What is wanted is confrontation, not archaeology
"Connect these concepts" No → forge What is wanted is forging, not excavation
"Help me read this paper" No → deep-read What is wanted is reading, not assumption analysis

Input parameters

Parameter Required Description
target Yes A claim (text), Source Brief path, Topic Note path, or URL
context No Background information: in what scenario this claim was raised, who raised it, and why it matters
depth No quick (only claim reconstruction → reasoning structure → assumption excavation, skipping hermeneutic review and alternative foundations) or deep (full five layers), default deep
output_dir No Output directory, overriding the default path rules

Output specification

File naming: {主题}-excavate_{YYYY-MM-DD}.md

Output path:

  1. If the user specified output_dir, write to the specified directory
  2. If a vault configuration exists (.loom/config.yaml in vault_path), write to <vault-root>/03_Content_Output/Longform/
  3. Otherwise write to the current working directory

File beginningMust include YAML front matter:

---
title: {主题}
date: {YYYY-MM-DD}
tags: [excavate, {主题标签}]
target_source: {输入来源}
status: draft
---

Excavation methodology

Four progressive layers, each building on the previous one:

Layer one: claim reconstruction

Reconstruct the input into the most specific original claim. Remove rhetoric, remove filler words, remove background setup.

Output:

  • Original claim: one sentence, subject-predicate-object complete
  • Claim type: factual judgment / value judgment / prediction / causal attribution / definition / methodological claim

Second layer: reasoning structure

Reconstruct the reasoning chain from "premises" to "claim".

Tool: 5 of the 8 Paul-Elder elements:

  1. Information: what information/data does this reasoning depend on?
  2. Reasoning: from information to conclusion, what reasoning steps were taken?
  3. Concepts: what core concepts were used? What are the definitions of these concepts?
  4. Perspective: from what standpoint/perspective is it made?
  5. Implications: if this claim holds, what conclusions are also implied?

Output:

  • Reasoning chain: premise A → reasoning step → premise B → reasoning step → conclusion (claim)
  • Type of each reasoning step: deduction / induction / analogy / appeal to authority / causal inference

Third layer: assumption mining

This is the core. From each step of the reasoning chain, extract what must be true but is never stated.

Mining toolbox (go through each at least once per assumption):

  1. Counterfactual test: if this assumption does not hold, at which step does the reasoning chain break?
  2. Mohist three tests:
    • Root: is there historical/empirical basis?
    • Origin: is it consistent with general observation?
    • Use: if you act on this assumption, can it produce the expected result?
  3. Category check: is this assumption about facts, about values, or about methods? Is there any confusion?
  4. Time check: did this assumption hold in the past, and does it still hold now? Have the conditions changed?

Output: list of assumptions, each assumption annotated with:

Assumption Type Test result Grounding rating
[specific assumption] fact/value/method three tests result grounded / inherited / spinning
  • Grounded: supported by evidence, withstands counterfactual testing
  • Inherited: comes from tradition/convention/authority, not independently verified
  • Spinning: self-contradictory, or clearly inconsistent with reality

Fourth layer: hermeneutic revisiting

Look back at the original claim from the assumption layer—after understanding the assumptions, has the meaning of the original claim changed?

This layer uses Gadamer's hermeneutic circle:

  1. Part→whole: put each assumption back into the overall reasoning chain and see how it changes the meaning of the conclusion
  2. Whole→part: from the new meaning of the conclusion, look back at each premise and see which premises' meanings have changed accordingly
  3. Fusion of horizons: the understanding you bring + the text's own logic = new understanding

Output:

  • Original claim (restated): after understanding the assumptions, a restatement of the same claim
  • Meaning drift: between the original formulation and the restatement, which meanings have changed?

Layer 5 (deep mode): Replacing the foundation

If the key assumptions are "inherited" or "idling," what different conclusions would exploring alternative assumptions lead to?

Tool: First-principles reconstruction

  1. Identify which assumptions are "well-grounded"—these are the new foundation
  2. Start from the well-grounded assumptions and reason anew
  3. See what conclusions the new reasoning leads to

Output:

  • Set of well-grounded assumptions: the premises you can restart from here
  • Alternative conclusions: if you use only the well-grounded assumptions, where does the reasoning chain lead?

Full structure of the excavation report

# 挖掘报告 — {主题}

## 原始主张
{一句话}

## 推理结构
前提 → 推理 → ... → 结论

## 假设清单
| # | 假设 | 类型 | 根基评级 | 断裂点 |
|---|------|------|----------|--------|
| 1 | ... | 事实 | 有根基 | — |
| 2 | ... | 价值 | 继承 | 如果不成立,推理在第 3 步断裂 |

## 关键假设详述
### 假设 2: {具体假设}
- 为什么它是必要的:{推理链中哪一步依赖它}
- 三表法检验:{结果}
- 反事实:如果它不成立,{会发生什么}

## 诠释学回看
- 原始表述:{原话}
- 重述:{理解假设后的重新表述}
- 含义漂移:{变化}

## 替代地基(如有)
- 有根基假设集合:{...}
- 替代推理链:{...}
- 替代结论:{...}

Speculative voice

Use the voice of a sharp interlocutor, not a scholar or assistant. Characteristics:

  • Make judgments directly, without elaboration
  • Use concrete examples instead of abstract argumentation
  • Say "I'm not sure here" about what's uncertain
  • Don't hedge (don't say "maybe," "to some extent")
  • Judgments can have an edge, but judgments must have grounds

Inherit the 9 red lines of deep-read: colloquial test, no jargon, short words, one thought per sentence, concrete, reasons first, no waffle, trust the reader, honesty.

Output in Chinese. Preserve key terms from the original text.

Dependent tools

Tool Purpose
Read Read Source Brief, Topic Note, local files
mcp__web-reader__webReader Fetch URL content
WebSearch Verify the factual basis of assumptions
Write Output the excavation report

Gotchas

Problem Rule
The input is pure opinion, with no reasoning chain First try to reconstruct the reasoning structure; if it can't be reconstructed, it means the assumptions themselves are implicit, so start directly from the assumption layer
There are too many assumptions to excavate them all Excavate only the key assumptions where "if it doesn't hold, the reasoning chain breaks"
What the user wants to excavate is itself a fact Facts also have assumptions—their measurement method, definitional boundaries, and scope of application may all be assumptions
The user disagrees with the rating of a certain assumption Explain the basis for your rating, but accept the user's judgment
The input comes from multiple sources First do claim reconstruction and reasoning structure separately for each source, then do cross-source comparison at the assumption layer