SuperAPI AI Directory

research-manager

Writing & research

View repository

Updated 10-16 03:44

About this skill

<project_state> Every project gets a workspace directory research/{slug}/ anchored at the user's invocation directory, containing project.json:

{
  "question": "the research question, verbatim",
  "methodology": "design recommended by research-methodology",
  "phase": "scoping | retrieval | analysis | synthesis | done",
  "workspaces": {"review": "review/{slug}/ if a literature funnel exists"},
  "decisions": [{"date": "YYYY-MM-DD", "decision": "...", "why": "..."}],
  "next_action": "the single next unblocked step, stated concretely"
}

Read-first: At the start of every session, before planning anything, check for an existing research/{slug}/project.json matching the topic. If found, resume from its phase and next_action — do not re-derive the plan. Write-last: After every completed task or user decision, update phase, append to decisions, and rewrite next_action. A session that changed project state but not project.json is unfinished. </project_state>

1. Ingestion & Scoping

Analyze the user's request. Is it a quick question or a project?

  • Quick: Answer directly using multi-source-investigation.
  • Project: Proceed to Task Scaffolding.
  • Clarification: If the request is ambiguous:
    • If AskUserQuestion is available: Call it to request details.
    • Otherwise: Ask the user directly in the conversation.

2. Protocol: Dynamic Scaffolding

DO NOT assume a standard workflow. Design the project based on the specific research question.

  1. Phase 1: Methodology Consultation (CRITICAL)

    • Action: Invoke research-methodology skill.
    • Query: "Target Topic: [Topic]. Recommend the optimal research design and phase breakdown."
    • Wait for the design output (e.g., "Systematic Review", "Ethnography", "A/B Test").
  2. Phase 2: Task Generation

    • Action: Transform the methodology's phases into a Task list.
    • Constraint: Every task must have a clear DONE condition.
    • Example: If Method="Systematic Review":
      • Task: Search Strategy (Dependencies: None)
      • Task: Screening (Dependencies: Search Strategy)
      • Task: Extraction (Dependencies: Screening)
  3. Phase 3: Persistence

    • Initialize research/{slug}/project.json with the question, methodology, phase: "scoping", and the first next_action.
    • If Task tool is available: Use it immediately to persist the list.
    • Otherwise: Create research/{slug}/research-tasks.md with the checklist.
    • Output: Confirm the plan to the user.

3. Execution & Delegation

Once the plan is created (and approved by the user), start executing the first unblocked task.

  • Delegate: "I am now acting as the [Skill Name] to complete Task [X]..."
  • Update: Mark tasks as specific statuses (IN_PROGRESS, DONE) as you go, and keep project.json current per <project_state> — every completed task updates phase and next_action.

<output_format> Project Plan: [Topic]

Objective: [One sentence goal]

Task List:

  • [1. Scoping]: [Description]
  • [2. Retrieval]: [Description] (Depends on 1)
  • ...

Ask the user: "Shall I initialize this task list and start with Phase 1?" </output_format>