autosurvey-execution

Installed Root

Resolve the installed reasflow-dev skills root before running packaged scripts:

REASFLOW_SKILLS_ROOT="${REASFLOW_SKILLS_ROOT:-}"
if [ -z "$REASFLOW_SKILLS_ROOT" ]; then
  if [ -d ./.agents/skills ]; then
    REASFLOW_SKILLS_ROOT="$(pwd)/.agents/skills"
  elif [ -d "$HOME/.agents/skills" ]; then
    REASFLOW_SKILLS_ROOT="$HOME/.agents/skills"
  else
    echo "reasflow shared skills not found in ./.agents/skills or $HOME/.agents/skills" >&2
    exit 1
  fi
fi

REASFLOW_PRIVATE_SKILLS_ROOT="${REASFLOW_PRIVATE_SKILLS_ROOT:-}"
if [ -z "$REASFLOW_PRIVATE_SKILLS_ROOT" ]; then
  if [ -d ./.codex/reasflow-skills ]; then
    REASFLOW_PRIVATE_SKILLS_ROOT="$(pwd)/.codex/reasflow-skills"
  elif [ -d "$HOME/.codex/reasflow-skills" ]; then
    REASFLOW_PRIVATE_SKILLS_ROOT="$HOME/.codex/reasflow-skills"
  else
    echo "reasflow private skills not found in ./.codex/reasflow-skills or $HOME/.codex/reasflow-skills" >&2
    exit 1
  fi
fi

AutoSurvey Execution

Overview

Run the AutoSurvey pipeline using Codex's configured model for all LLM work. Python handles data operations and prompt preparation; Codex survey subagents handle the actual drafting stages.

Architecture

Three layers:

1. Python autosurvey_tools.py — pure data operations + prompt preparation using AutoSurvey's original templates. Outputs JSON files with prepared prompts.
2. Codex subagents — survey-outline, survey-section-writer, survey-related-works, survey-judge.
3. Workspace artifacts — prompt JSON, outline Markdown, survey draft, and LaTeX/BibTeX outputs.

batch_chat maps to multiple spawn_agent calls, each followed by wait_agent. chat maps to one spawn_agent + wait_agent.

Retrieval inside the writing stages prefers the local paper pool. When --library-dir (default survey/library) contains paper JSON produced by the autosurvey-paper-retrieval skill, autosurvey_tools.py builds an in-memory ExternalPaperDatabase from it and never touches AutoSurvey's embedding/Pinecone stack. AutoSurvey is only loaded as a fallback when the library is empty.