Add Codex research skills and setup docs

Include Codex setup docs, installer updates, and switch the OpenCode web research agent default model to gpt-5.4.
This commit is contained in:
jilinchen
2026-03-08 23:33:38 +08:00
parent c360ddc185
commit 9c79d61747
23 changed files with 1549 additions and 9 deletions
+59 -4
View File
@@ -1,4 +1,4 @@
# Deep Research Skill for Claude Code / OpenCode
# Deep Research Skill for Claude Code / OpenCode / Codex
[English](README.md) | [中文](README.zh.md)
@@ -6,7 +6,7 @@
> 灵感来源:[RhinoInsight: Improving Deep Research through Control Mechanisms for Model Behavior and Context](https://arxiv.org/abs/2511.18743)
Claude Code 的结构化调研工作流技能,支持两阶段调研:outline生成(可扩展)和深度调查。人在回路设计确保每个阶段的精确控制。
适用于 Claude Code、OpenCode 和 Codex 的结构化调研工作流技能,支持两阶段调研:outline生成(可扩展)和深度调查。人在回路设计确保每个阶段的精确控制。
![Deep Research Skills 工作流](workflow.png)
@@ -19,6 +19,11 @@ Claude Code 的结构化调研工作流技能,支持两阶段调研:outline
## 安装
```bash
git clone https://github.com/Weizhena/deep-research-skills.git
cd deep-research-skills
```
### Claude Code
```bash
# 中文版
@@ -35,7 +40,7 @@ cp -r agents/web-search-modules ~/.claude/agents/
pip install pyyaml
```
### OpenCode (默认: gpt-5.2)
### OpenCode (默认: gpt-5.4)
```bash
# Skills (同 Claude Code)
cp -r skills/research-zh/* ~/.claude/skills/ # 或 research-en 英文版
@@ -48,11 +53,56 @@ cp -r agents/web-search-modules ~/.config/opencode/agents/
pip install pyyaml
```
> **重要**:当 OpenCode 使用 Codex 模型时,目前**没有**原生 `web search`,只有 `web fetch`。这会直接影响深度调研阶段,README 里需要重点标注。
### Codex
```bash
# 英文版
mkdir -p ~/.codex/skills ~/.codex/agents
cp -r skills/research-codex-en/* ~/.codex/skills/
# 中文版
mkdir -p ~/.codex/skills ~/.codex/agents
cp -r skills/research-codex-zh/* ~/.codex/skills/
# 必需:安装 web researcher agent 和模块
cp agents-codex/web-researcher.toml ~/.codex/agents/
cp -r agents-codex/web-search-modules ~/.codex/agents/
# 必需:安装 Python 依赖
pip install pyyaml
```
使用以下两种方式之一更新 `~/.codex/config.toml`
**方式 A:自动脚本**
```bash
cd deep-research-skills
bash scripts/install-codex.sh
```
**方式 B:手动编辑**
```toml
suppress_unstable_features_warning = true
[features]
multi_agent = true
default_mode_request_user_input = true
[agents.web_researcher]
description = "Use this agent when you need to research information on the internet, particularly for debugging issues, finding solutions to technical problems, or gathering comprehensive information from multiple sources. This agent excels at finding relevant discussions. Use when you need creative search strategies, thorough investigation, or compilation of findings from multiple sources."
config_file = "agents/web-researcher.toml"
```
## 命令
> **Claude Code 2.1.0+**:现已支持直接 `/skill-name` 触发!
>
> **旧版本**:请使用 `run /skill-name` 格式。
>
> **Codex**:可以通过 `/skills` -> `List Skills` 选择这些 skills,也可以用自然语言触发,例如 `Use the research skill to build an outline for AI Agent Demo 2025`。
| 命令 (2.1.0+) | 描述 |
|---------------|------|
@@ -72,6 +122,11 @@ pip install pyyaml
```
💡 **会发生什么**:告诉它你要研究什么 → 它帮你列出调研清单
对于 Codex,可以这样说:
```
Use the research skill to build an outline for AI Agent Demo 2025
```
**你会得到**17个待调研的AI Agent清单(ChatGPT Agent、Claude Computer Use、Cursor等)+ 每个要收集哪些信息
### (可选)不满意?继续添加
@@ -99,7 +154,7 @@ pip install pyyaml
## 遇到问题?
如果过程中有什么不懂的,可以让Claude Code帮你理解这个项目:
如果过程中有什么不懂的,可以让 Claude Code、OpenCode 或 Codex 帮你理解这个项目:
```
帮我理解这个项目: https://github.com/Weizhena/deep-research-skills
```