deeptutor-research

DeepTutor Research

任务

通过 DeepTutor CLI 进行体系化知识研究，包括知识库管理、深度研究、细节检索、问题求解。所有输出为结构化 JSON，供 wiki-compiler 等 Agent 消费。

前置条件

条件	检测方式	说明
DeepTutor 已部署	调用 deeptutor-setup Skill	CLI 可用 + API key 已配置
知识库已创建	deeptutor kb list	首次使用需创建

CLI 路径

.claude/tools/DeepTutor/deeptutor.bat

所有命令加 -f json 获取结构化输出。

操作集

1. 知识库管理

1.1 列出知识库

.claude/tools/DeepTutor/deeptutor.bat kb list -f json

1.2 创建知识库

.claude/tools/DeepTutor/deeptutor.bat kb create {kb_name} --doc {file1} --doc {file2} -f json

• 命名规范：chip-{主题小写}，如 chip-axi4stream、chip-chi
• 支持格式：PDF、Markdown、TXT
• 可重复执行：已存在时会报错，需先检查

1.3 添加文档（增量）

.claude/tools/DeepTutor/deeptutor.bat kb add {kb_name} --doc {new_file} -f json

1.4 删除知识库

.claude/tools/DeepTutor/deeptutor.bat kb delete {kb_name} --force -f json

2. 深度研究（核心能力）

对一个主题进行多 Agent 协作研究，输出带引用的结构化报告。

.claude/tools/DeepTutor/deeptutor.bat run deep_research "{研究主题描述}" --kb {kb_name} -f json

参数说明：

参数	必填	说明
研究主题	是	自然语言描述，越具体越好
--kb	否	指定知识库，不指定则用默认
-t	否	启用工具：rag、web_search、paper_search、reason
-f json	是	结构化输出

使用示例：

# 基于知识库研究
.claude/tools/DeepTutor/deeptutor.bat run deep_research \
  "CHI 协议 Snoop Filter 设计策略，包括目录式和广播式对比" \
  --kb chip-chi -f json

# 启用多工具研究
.claude/tools/DeepTutor/deeptutor.bat run deep_research \
  "PCIe Gen5/Gen6 链路训练与均衡策略" \
  -t rag -t web_search -t paper_search -f json

输出处理：

提取 JSON 结果中的：

• findings → 核心发现，用于 entity 页面的"核心特性"
• sources → 引用来源，用于页面"参考"章节
• subtopics → 子主题，用于决定是否需要额外页面

3. 知识库检索（细节补充）

针对具体问题进行语义搜索。

.claude/tools/DeepTutor/deeptutor.bat kb search {kb_name} "{查询内容}" -f json

使用示例：

.claude/tools/DeepTutor/deeptutor.bat kb search chip-chi \
  "Retry mechanism and P-Credit flow control" -f json

.claude/tools/DeepTutor/deeptutor.bat kb search chip-axi4 \
  "write data channel handshake timing" -f json