research-setup

name	research-setup
description	从研究目标出发，通过深度讨论挖掘所有研究议题，生成结构化的 handoff 文档和依赖追踪器。 使用场景：启动一个新的研究项目、规划研究议题、为 AI Agent 准备可执行的研究任务。 当用户说"规划研究议题"、"创建研究项目"、"准备 handoff 文档"、"研究议题拆解"时触发。

Research Setup — 研究议题规划与 Handoff 文档生成

从研究目标出发，通过深度讨论系统性地挖掘研究议题，生成 Agent 可直接执行的 handoff 文档和依赖追踪器。

子 Skill 编排

Phase 1: grill-me ──→ 深度讨论，挖掘所有研究议题
Phase 2: （纯文件操作）──→ 创建项目目录结构
Phase 3: handoff ──→ 将讨论结果压缩为结构化 handoff 文档
Phase 4: （纯文件操作）──→ 审查、修复、提交

子 Skill	阶段	用途
grill-me	Phase 1	深度讨论，从研究目标中系统性挖掘所有议题
handoff	Phase 3	将讨论结果压缩为结构化的 handoff 文档

---

Phase 1: 深度讨论（grill-me）

目的：通过连续追问，从研究目标中系统性地挖掘出所有需要研究的议题。

调用方式：在对话中使用 /grill-me 触发深度讨论，或直接使用 Skill tool 调用 grill-me。

讨论维度：

1. 研究目标的本质是什么？（不沿用旧方案，从需求出发）
2. 达成目标需要哪些前置条件？
3. 哪些是技术问题、哪些是理论问题、哪些是数据问题？
4. 议题之间的依赖关系是什么？
5. 哪些议题有硬件/数据/算力约束？

讨论结果捕获：讨论结束后，将结果整理为以下格式，保存在对话上下文中（不需要写文件），供 Phase 3 使用：

## 议题清单
| 编号 | 名称 | 优先级 | 核心问题 | 依赖 |
|------|------|--------|----------|------|
| R1 | ... | P0 | ... | — |
| R2 | ... | P0 | ... | R1 |

## 依赖关系图
R1 → R3
R2 → R3
R4 → R5

## 约束条件
- 硬件：...
- 数据：...
- 范围：...

产出：议题清单 + 依赖关系图 + 约束条件（保存在对话上下文中）

---

Phase 2: 创建项目结构

Phase 1 完成后，立即创建目录结构。在 projects/{project-name}/ 下：

projects/{project-name}/
├── {project-name}.md          # 项目概览
├── handoff/
│   ├── RESEARCH-TRACKER.md    # 议题状态追踪器（单一事实来源）
│   ├── R1-{topic-slug}.md     # 议题 1 handoff
│   ├── R2-{topic-slug}.md     # 议题 2 handoff
│   └── ...
├── experiments/
│   └── README.md              # 实验代码目录说明
└── outputs/
    └── README.md              # 实验结论存放说明

同步更新：

• index.md — 添加新项目链接
• AGENTS.md — 添加研究项目入口
• .manifest.json — 更新统计
• hot.md / log.md — 记录操作

---

Phase 3: 生成 Handoff 文档（handoff）

核心 Skill：使用 handoff skill 将讨论结果压缩为结构化文档。调用方式：/handoff 或 Skill tool 调用 handoff。

流程：

1. 从 Phase 1 的议题清单中，逐个议题生成 handoff 文档
2. 每个 handoff 文档使用下方模板，填入讨论阶段的研究结果
3. 写入 projects/{project-name}/handoff/R{N}-{topic-slug}.md

sources 字段确定方法：搜索以下目录，找到与当前议题相关的文件：

• references/ — 用 grep -r "{关键词}" references/ 搜索相关论文
• concepts/ — 用 grep -r "{关键词}" concepts/ 搜索相关概念
• synthesis/ — 检查是否有跨领域综合分析与当前议题相关
• projects/ — 检查是否有子项目文档与当前议题相关

Handoff 文档结构

---
title: "Handoff: R{N} — {议题名称}"
category: projects
tags: [{domain-tag}, {type-tag}, research-handoff]
sources:
  - {本地知识库中相关的文件路径}
created: {YYYY-MM-DD}
updated: {YYYY-MM-DD}
summary: "{一句话摘要}"
---

# Handoff: R{N} — {议题名称}

## 任务编号
R{N}（{P0/P1/P2} 优先级）

## 研究问题
{核心研究问题}

## 背景
{为什么需要研究这个议题}

## 研究方法
### 来源 1：本地知识库
### 来源 2：网络研究
### ChatGPT 深度研究提示词

## 研究任务
## 约束条件
- **方法论约束**：不以旧方案为锚点，从实际需求出发重新设计验证

## 交付物
## 需要阅读的文件
## 相关议题（依赖关系）

RESEARCH-TRACKER.md 结构

## 议题状态总览
| 编号 | 议题 | 优先级 | 状态 | Handoff 文档 |

## 依赖关系
{ASCII 依赖关系图}

## 可用技能
{只推荐，不强制}

完整模板见 references/tracker-template.md

---

Phase 4: 审查、修复、提交

审查清单

1. 每个议题是否有 handoff？是否包含所有必要部分？
2. RESEARCH-TRACKER 链接路径是否正确？
3. category 是否为 projects？标签是否符合 taxonomy？
4. .manifest.json / index.md / hot.md / log.md 是否更新？
5. 依赖关系图是否正确？无循环？P0 不依赖 P1/P2？
6. 每个 handoff 是否包含"不沿用旧方案"约束？

提交

git add projects/{project-name}/ AGENTS.md index.md hot.md log.md .manifest.json _meta/taxonomy.md
git commit -m "feat: add {project-name} research infrastructure"
git push

---

关键教训

1. Handoff 中不要硬性指定 skill — 只推荐，不强制
2. sources 字段要全面 — 包括 references/、concepts/、synthesis/、projects/ 中的相关文件
3. 每个 handoff 必须包含 ChatGPT 深度研究提示词 — 网络研究备选方案
4. category 必须是 projects
5. 标签必须符合 taxonomy — 新标签先注册
6. Tracker 表格只有 5 列 — 无多余列
7. 依赖关系必须明确标注 — 依赖图 + handoff 的"相关议题"部分