mcpField
S
survey-seed-harvest

survey-seed-harvest

github.com/willoscar生产力51741 次安装3 周前更新
代码仓库

关于 survey-seed-harvest

survey-seed-harvest 是用于综述研究前期结构整理的技能，从已去重论文中提取主题术语，生成待完善的分类法种子。它通过关键词筛选综述类论文，为 taxonomy-builder 提供起点，而非替代后续整理。

主要功能

  1. 01从去重论文元数据中筛选综述
  2. 02提取候选主题词并分组
  3. 03生成带描述的多层分类法种子
  4. 04可设置候选词数量与频率阈值
  5. 05输出 outline/taxonomy.yml

适用场景

  1. 01用已有综述论文快速搭建主题分类
  2. 02为 taxonomy-builder 准备初始分类种子

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/survey-seed-harvest确认已加载。

附带文件scripts/run.py

详细介绍

调查种子提取

触发条件与路由

  • 触发条件：调查种子提取、分类法种子、从调查论文提取分类法、引导分类法。
  • 适用场景：检索/去重后，想快速从已有的调查/综述论文中提取术语与主题结构，以加速 taxonomy-builder。

从检索结果集中现有的调查/综述论文中引导出分类法种子。

这是早期结构阶段的加速器：它应让 taxonomy-builder 更容易使用，而不是取而代之。

输入

  • papers/papers_dedup.jsonl（包含标题/摘要的去重论文元数据）

输出

  • outline/taxonomy.yml（分类法种子；预期需要进一步完善）

工作流（启发式）

使用：papers/papers_dedup.jsonl。

  1. 找出可能的调查/综述论文：
    • 标题/摘要包含 “survey”、“review”、“systematic”、“meta-analysis”
  2. 提取候选主题术语，并将其分组为：
    • 约 4–10 个顶层节点（“章节”）
    • 每个节点包含 2–6 个子节点（可映射的叶节点）
  3. 编写简短、可执行的描述：
    • 说明哪些内容属于此类，哪些不属于
    • （可选）列出 2–5 个代表性标题作为种子
  4. 将结果视为起点：
    • 将其传递给 taxonomy-builder，以便进行符合领域语义的改写并对齐范围。

质量检查清单

  • outline/taxonomy.yml 存在且为有效 YAML。
  • 分类法至少包含 2 个层级（使用 children），且每个节点都有描述。
  • 避免使用“概述/基准/开放问题”等通用占位节点，除非它们确实反映了你所在领域的内容。

脚本（可选辅助工具）

快速开始
  • 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>
所有选项
  • --top-k <n>：要考虑的候选术语数量
  • --min-freq <n>：最低频率阈值
示例
  • 使用更保守的术语选择：
    • uv run python .codex/skills/survey-seed-harvest/scripts/run.py --workspace <workspace> --top-k 80 --min-freq 3
注意事项
  • 此辅助工具基于关键词；请将输出视为种子，并使用 taxonomy-builder 进一步完善。

故障排除

问题：未检测到集合中的调查/综述论文

修复方法：

  • 扩大检索范围（添加 “survey”、“review”、“benchmark” 等变体），或手动添加几篇已知调查论文作为种子，然后重新运行。
问题：分类法种子看起来像通用类别

修复方法：

  • 确保种子具体（列出命名方法/基准/任务），并依靠 taxonomy-builder 根据实际范围进行改写。

评论

支持 Markdown