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:
+59
-4
@@ -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生成(可扩展)和深度调查。人在回路设计确保每个阶段的精确控制。
|
||||
|
||||

|
||||
|
||||
@@ -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
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user