docs: add workflow phase descriptions

- Add detailed explanations for each workflow phase
- Describe outputs for each stage

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
jilinchen
2026-01-07 01:54:05 +08:00
co-authored by Claude Opus 4.5
parent 5ae9dbf2a6
commit 39abbd0be3
+29 -5
View File
@@ -48,22 +48,34 @@ cp agents/web-search-agent.md ~/.claude/agents/
```
/research <topic>
```
- Model knowledge generates initial items and field framework
- Web search supplements latest items
- User confirms and adjusts
- Outputs: `outline.yaml` (items + config) + `fields.yaml` (field definitions)
#### Phase 2: Deep Research
```
/research/deep
```
- Parallel agents research each item (batch_size configurable)
- Each agent reads fields.yaml and outputs structured JSON
- Supports checkpoint resume
- Outputs: `results/*.json`
#### Optional: Expand Outline
```
/research/add-items
/research/add-fields
/research/add-items # Add research targets via user input or web search
/research/add-fields # Add field definitions
```
#### Phase 3: Generate Report
```
/research/report
```
- Generates Python script to convert JSON to markdown
- User selects summary fields for TOC
- Skips uncertain values automatically
- Outputs: `report.md`
---
@@ -99,7 +111,7 @@ Claude Code 的结构化调研工作流技能,支持两阶段调研:outline
cp -r skills/research-en ~/.claude/skills/research
# 中文版
cp -r skills/research-zh ~/.claude/commands/research
cp -r skills/research-zh ~/.claude/skills/research
# 必需:安装agent
cp agents/web-search-agent.md ~/.claude/agents/
@@ -111,22 +123,34 @@ cp agents/web-search-agent.md ~/.claude/agents/
```
/research <topic>
```
- 模型知识生成初始items和字段框架
- 网络搜索补充最新items
- 用户确认并调整
- 输出:`outline.yaml`items + 配置)+ `fields.yaml`(字段定义)
#### 阶段2:深度调研
```
/research/deep
```
- 并行agents调研每个itembatch_size可配置)
- 每个agent读取fields.yaml并输出结构化JSON
- 支持断点续传
- 输出:`results/*.json`
#### 可选:扩展Outline
```
/research/add-items
/research/add-fields
/research/add-items # 通过用户输入或网络搜索添加调研对象
/research/add-fields # 添加字段定义
```
#### 阶段3:生成报告
```
/research/report
```
- 生成Python脚本将JSON转换为markdown
- 用户选择目录中显示的摘要字段
- 自动跳过不确定值
- 输出:`report.md`
---