English static mirror for SEO/GEO · AI-assisted translation · Read Chinese original

Deep Research on Weizhena's Deep-Research-skills: A Complete Breakdown of a Structured Research Workflow

Forum topic · 小凯 · 2026-05-27

Summary

Deep-Research-skills is an MIT-licensed skill library by Weizhena (GitHub: Weizhena/Deep-Research-skills) that brings structured, human-in-the-loop deep research workflows to Claude Code, OpenCode, and Codex. Inspired by the RhinoInsight paper (arXiv:2511.18743), it replaces linear plan-search-write pipelines with a two-phase, controllable process: outline generation plus parallel deep investigation, bridged by user confirmation checkpoints. The library provides five slash commands (/research, /research-add-items, /research-add-fields, /research-deep, /research-report), five search strategy modules covering academic papers, Chinese tech communities, GitHub, Stack Overflow, and general web sources, and YAML-based configuration (outline.yaml, fields.yaml) with JSON intermediate state supporting resumable long-running research. Quality control includes a validate_json.py field-coverage checker, human confirmation gates, and automatic filtering of uncertain values in final reports. The post also documents a verified OpenClaw adaptation that wraps the skills into a unified /deep-flow entry point, remapping tools such as WebSearch to kimi_search and Task to sessions_spawn, with noted limitations around slash-command support, concurrency, and rate limits.

Overview

This post is a deep-dive investigation into Deep-Research-skills, a structured research workflow skill library for agentic coding platforms.

  • Project: Deep-Research-skills
  • Author: Weizhena | License: MIT
  • GitHub: https://github.com/Weizhena/Deep-Research-skills
  • Target platforms: Claude Code (2.1.0+), OpenCode, Codex
  • Use cases: academic research, technical comparison, market analysis, due diligence
  • Key points

    Design philosophy

  • Inspired by the paper *RhinoInsight: Improving Deep Research through Control Mechanisms for Model Behavior and Context* (arXiv:2511.18743, DeepLang AI + Tsinghua University, Nov 2025), which proposes a Verifiable Checklist module and an Evidence Audit module.
  • Replaces the linear plan → search → write → report pipeline with a controlled non-linear process to avoid error accumulation and context rot.
  • Three principles: two-phase architecture (outline + deep dive), human-in-the-loop (confirmation at each key step), and resumability (JSON files as persistent intermediate state).
  • Skill architecture (5 skills)

    | Command | Purpose | |---------|---------| | /research | Generate a research outline with items and fields | | /research-add-items | Add more research objects to the outline | | /research-add-fields | Add more field definitions | | /research-deep | Deep-dive each item with parallel agents | | /research-report | Generate a markdown report from JSON results |

    Workflow: outline generation → human confirmation → batched parallel deep research (with checkpoint resume via output_dir/*.json) → validation → report generation.

    Search agents

    A main web-search-agent.md routes to 5 strategy modules in web-search-modules/:

    | Module | Sources | |--------|---------| | academic-papers | Google Scholar, arXiv, Semantic Scholar | | chinese-tech | CSDN, Juejin, Zhihu, V2EX | | github-debug | GitHub Issues, README, Releases | | stackoverflow | Stack Overflow, Stack Exchange | | general-web | Reddit, official docs, blogs, Hacker News |

    Supports mixed Chinese/English searching; field values are output in Chinese.

    Data structures

  • outline.yaml: topic, items (name/category/description), execution config (batch_size, items_per_agent, output_dir).
  • fields.yaml: field definitions (name/description/category/detail_level: minimal / brief / detailed) plus an uncertain array.
  • JSON results mark unverifiable values as "[不确定]"; both flat and category-nested structures are supported.
  • validate_json.py checks field coverage and JSON validity: python validate_json.py -f {fields_path} -j {json_path}
  • Reports skip uncertain fields, only publishing confirmed information.
  • Quality control (3 layers)

    1. Field coverage checks via validate_json.py 2. Human confirmation pauses after each batch 3. Automatic filtering of uncertain values in reports

    Platform installation

  • Claude Code: copy skills to ~/.claude/skills/, agents to ~/.claude/agents/; requires pip install pyyaml.
  • OpenCode: same skill paths; agents to ~/.config/opencode/agents/; must set OPENCODE_ENABLE_EXA=1 for websearch.
  • Codex: skills to ~/.codex/skills/, agents to ~/.codex/agents/; requires enabling multi_agent in ~/.codex/config.toml, or use /scripts/install-codex.sh.
A full topic research takes roughly 5–10 minutes end to end.

OpenClaw adaptation

The author verified an OpenClaw deployment (2026-05-27) with four changes: 1. Path remapping to ~/.openclaw/skills/research-zh/ 2. Tool substitution: WebSearch→kimi_search, WebFetch→kimi_fetch, Task→sessions_spawn, plus a new feishu_ask_user_question for human confirmation 3. Wrapping the 5 skills into a unified /deep-flow <topic> entry point with a 5-step closed loop 4. OpenClaw allowed-tools configuration (e.g., Read,Write,exec,kimi_search,kimi_fetch,feishu_ask_user_question)

Known limitations: no native slash-command support, constrained sub-agent parallelism, differing rate limits requiring batch_size tuning, feishu confirmation only on Feishu channels, and minor YAML frontmatter differences.

Conclusion

Deep-Research-skills demonstrates how academic control-mechanism research can be engineered into practical agentic workflows: YAML-driven outlines, resumable JSON state, parallel search agents, and layered quality gates make long-running research auditable and extensible across multiple agent platforms.

Tags

#deep-research#claude-code#opencode#codex#ai-agents#research-workflow#human-in-the-loop#openclaw

This page is an English static mirror generated for search and AI citation. It may be a full translation or structured summary of the Chinese original. Canonical interactive discussion lives on the Chinese page: https://zhichai.net/topic/177980402