mcpField
S
survey-seed-harvest

survey-seed-harvest

github.com/willoscarProductivity51741 installsUpdated 4w ago
Repository

About survey-seed-harvest

survey-seed-harvest is a skill for early-stage structure building in survey research. It extracts topic terms from deduplicated papers to create taxonomy seeds, using survey and review papers as a starting point for taxonomy-builder rather than replacing it.

Key features

  1. 01Identify survey and review papers in deduplicated metadata
  2. 02Extract and group candidate topic terms
  3. 03Create described, multi-level taxonomy seeds
  4. 04Set candidate-term and frequency thresholds
  5. 05Write outline/taxonomy.yml

Use cases

  1. 01Building an initial topic taxonomy from existing surveys
  2. 02Preparing seed categories for taxonomy-builder

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill survey-seed-harvest

After installing, type/survey-seed-harvestin Claude Code to confirm it loaded.

Bundled filesscripts/run.py

Details

From the project README

Survey Seed Harvest

Triggers & routing

  • Trigger: survey seed harvest, taxonomy seeds, 从 survey 提 taxonomy, bootstrap taxonomy.
  • Use when: retrieval/dedup 后想快速从已有 survey/review 论文中提取术语与主题结构，用于加速 taxonomy-builder。

Bootstrap taxonomy seeds from existing survey/review papers inside your retrieved set.

This is an accelerator for the early structure stage: it should make taxonomy-builder easier, not replace it.

Inputs

  • papers/papers_dedup.jsonl (deduped paper metadata with titles/abstracts)

Outputs

  • outline/taxonomy.yml (seed taxonomy; expected to be refined)

Workflow (heuristic)

Uses: papers/papers_dedup.jsonl.

  1. Find likely survey/review papers:
    • title/abstract contains “survey”, “review”, “systematic”, “meta-analysis”
  2. Extract candidate topic terms and group them into:
    • ~4–10 top-level nodes (“chapters”)
    • 2–6 children per node (mappable leaves)
  3. Write short, actionable descriptions:
    • what belongs here / what does not
    • (optional) list 2–5 representative titles as seeds
  4. Treat the result as a starting point:
    • pass it to taxonomy-builder for domain-meaningful rewriting and scope alignment.

Quality checklist

  • outline/taxonomy.yml exists and is valid YAML.
  • Taxonomy has at least 2 levels (children used) and every node has a description.
  • Avoid generic placeholder nodes like “Overview/Benchmarks/Open Problems” unless they are truly content-based for your domain.

Script (optional helper)

Quick Start
  • uv run python .codex/skills/survey-seed-harvest/scripts/run.py --help
  • uv run python .codex/skills/survey-seed-harvest/scripts/run.py --workspace <workspace>
All Options
  • --top-k <n>: number of candidate terms to consider
  • --min-freq <n>: minimum frequency threshold
Examples
  • More conservative term selection:
    • uv run python .codex/skills/survey-seed-harvest/scripts/run.py --workspace <workspace> --top-k 80 --min-freq 3
Notes
  • This helper is keyword-based; treat the output as seeds and refine with taxonomy-builder.

Troubleshooting

Issue: no survey/review papers are detected in the set

Fix:

  • Broaden retrieval (add “survey”, “review”, “benchmark” variants) or manually seed a few known surveys, then rerun.
Issue: taxonomy seeds look like generic buckets

Fix:

  • Keep seeds concrete (named methods/benchmarks/tasks) and rely on taxonomy-builder to rewrite under the actual scope.

Comments

Markdown supported