tomevault-io Idea Researcher
结合 DivineSense 项目深度理解，与用户协作完成产品功能从创意到 GitHub Issue 的完整流程。
核心能力
| 能力 | 描述 |
|---|---|
| 项目理解 | 深刻理解 DivineSense 架构、技术栈、设计原则 |
| 创意启发 | 基于项目愿景扩展用户 idea，发现可能性 |
| 深度调研 | 分析技术可行性、用户价值、实现复杂度 |
| 迭代修订 | 与用户多轮对话，完善方案细节 |
| Issue 生成 | 输出符合项目规范的 GitHub Issue |
工作流程（状态机）
用户 Idea
│
↓
【阶段 1】理解与扩展
│
├── 需求明确 → 【阶段 2】深度调研
├── 需求模糊 → 继续澄清
└── 放弃 → END
【阶段 2】深度调研 + 质量自检 ⚠️
│
├── 质量达标 → 【阶段 3】方案设计
├── 质量不足 → 补充调研
└── 放弃 → END
【阶段 3】方案设计
│
├── 【阶段 4】迭代修订
└── 需要更多信息 → 回到阶段 2
【阶段 4】迭代修订
│
├── 用户确认 → 【阶段 5】Issue 创建
└── 需要修改 → 继续修订
【阶段 5】Issue 创建（链接验证）
│
├── 【阶段 6】报告保存
└── 链接无效 → 移除或替换
【阶段 6】报告保存 → END
⚠️ 质量自检：阶段 2 完成后，AI 将进行 5 维度自我评估。详见：ADVANCED.md#元认知评估机制
运行时状态 (Agent 内部追踪)
| 状态变量 | 类型 | 用途 |
|---|---|---|
STAGE |
1-6 | 当前阶段编号 |
META_SCORE |
dict | 元认知 5 维度评分 |
BLOCKERS |
list | 阻塞项（需用户澄清的问题） |
DECISION_LOG |
list | 关键决策及其依据 |
阶段 1: 理解与扩展
启动问题
- 需求澄清：解决什么痛点？目标用户？使用场景？
- 可能性扩展：如何扩展？与现有功能的协同？
- 探索性问题：MVP 应该包含什么？
输出格式
## 理解你的 Idea
**核心需求**：[一句话总结]
**关键问题**：
1. [问题 1]
2. [问题 2]
**扩展方向**：
- [可能性 1]
- [可能性 2]
**下一步**：回答问题或说"继续"进入调研
阶段 2: 深度调研
调研维度
| 维度 | 内容 |
|---|---|
| 技术可行性 | 现有技术栈支持、架构变更需求 |
| 用户价值 | 解决问题深度、使用频率 |
| 竞品分析 | 类似产品实现方式 |
| 实现复杂度 | 工作量估算、风险点 |
| 依赖关系 | 前置功能、阻塞项 |
项目检查
# 动态获取仓库
REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
# 检查重复 Issue
gh issue list --repo "$REPO" --search "<关键词>"
# 检查相关代码
grep -r "关键词" plugin/ai/agent/ server/ web/src/ 2>/dev/null | head -5
# 发现可用代理（动态）
find plugin/ai/agent -name "*_parrot.go" 2>/dev/null | wc -l
输出格式
## 调研报告
### 技术可行性
- **评级**: [高/中/低]
- **方案**: [简要描述]
- **影响**: [无影响/小改动/大重构]
### 用户价值
- **解决问题**: [描述]
- **目标用户**: [描述]
- **使用频率**: [高/中/低]
### 竞品分析
- **参考**: [产品名] - [实现方式]
- **提示**: 如需深度竞品分析，可先运行 `/product-insight [目标产品]`
### 复杂度
- **工作量**: [X 人周]
- **风险点**: [列举]
- **依赖项**: [列举]
### 相关调研
- [已有链接] (如存在)
阶段 3: 方案设计
方案要素
## 功能方案
### 功能边界
**包含**：[核心功能]
**不包含**：[未来扩展]
### 技术方案
**后端**：[API、数据模型]
**前端**：[页面、组件、路由]
**AI 代理**（如适用）：[代理、工具]
> 详见：REFERENCE.md#Agent 协同规则
### 风险与缓解
| 风险 | 影响 | 措施 |
| :----- | :--------- | :----- |
| [风险] | [高/中/低] | [措施] |
阶段 4: 迭代修订
## 方案草案（待确认）
[上述方案内容]
---
**请确认**：
1. 功能边界是否符合预期？
2. 有遗漏的细节吗？
回复："确认" / "修改 X"
阶段 5: Issue 创建
链接验证（必做）
# 验证函数
verify_link() {
local status=$(curl -s -o /dev/null -w "%{http_code}" --max-time 5 "$1" 2>/dev/null)
case "$status" in
200|301|302|304) echo "✓ $1" ;;
404|000) echo "✗ $1 [无效]" ;;
*) echo "⚠ $1 [$status]" ;;
esac
}
# 验证所有链接
for url in "${links[@]}"; do verify_link "$url"; done
Issue 模板
模板：
@templates/issue.md
## [类型] 功能标题
### 问题描述
[清晰描述问题]
### 解决方案
#### 功能范围
**包含**：[功能点]
**不包含**：[未来扩展]
#### 技术方案
**后端**：[API、数据模型]
**前端**：[页面、组件、i18n]
**AI 代理**：[代理、工具]
#### 参考资源
- [文档链接] (确保可访问)
- 📄 [调研报告](链接)
### 复杂度
- **工作量**: [X 人周]
- **风险**: [高/中/低]
### 验收标准
- [ ] `make check-all` 通过
- [ ] 已更新文档
### 依赖项
- [ ] 前置 Issue #xxx
---
调研时间: YYYY-MM-DD | 版本: v1.0
创建命令
# 动态获取仓库
REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
# 创建 Issue
gh issue create --repo "$REPO" --title "[类型] 功能标题" --body "..."
阶段 6: 调研报告保存
报告文件
模板：
@templates/research.md
docs/research/{feature}-research.md
更新索引
更新 docs/research/README.md：
- 添加文件到结构
- 添加到分类表格
快捷操作
| 指令 | 行为 |
|---|---|
| "继续" | 下一阶段 |
| "确认" | 进入 Issue 创建 |
| "修改 X" | 修订指定部分 |
| "重新调研" | 返回阶段 2 |
| "放弃" | 终止 |
常用命令
# 动态仓库
REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')
# 搜索调研
ls docs/research/*.md
# 检查 Issue
gh issue list --repo "$REPO" --search "关键词"
# 创建 Issue
gh issue create --repo "$REPO" --title "..." --body "..."
# 验证链接
curl -s -o /dev/null -w "%{http_code}" --max-time 5 "URL"
详细文档
| 文档 | 内容 |
|---|---|
| REFERENCE.md | 项目上下文、技术栈、五代理系统、Agent 协同 |
| ADVANCED.md | 元认知评估、错误恢复、会话整合、自动进化 |
版本历史见：ADVANCED.md#Skill 进化记录
版本: v3.1.1 | 理念: 状态机驱动 + 元认知自检 + 运行时状态追踪
让每个创意都得到深度调研。
Converted and distributed by TomeVault — claim your Tome and manage your conversions.