Idea Researcher

结合 DivineSense 项目深度理解，与用户协作完成产品功能从创意到 GitHub Issue 的完整流程。

核心能力

能力	描述
项目理解	深刻理解 DivineSense 架构、技术栈、设计原则
创意启发	基于项目愿景扩展用户 idea，发现可能性
深度调研	分析技术可行性、用户价值、实现复杂度
迭代修订	与用户多轮对话，完善方案细节
Issue 生成	输出符合项目规范的 GitHub Issue

工作流程（状态机）

code

用户 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 应该包含什么？

输出格式

markdown

## 理解你的 Idea

**核心需求**：[一句话总结]

**关键问题**：
1. [问题 1]
2. [问题 2]

**扩展方向**：
- [可能性 1]
- [可能性 2]

**下一步**：回答问题或说"继续"进入调研

阶段 2: 深度调研

调研维度

维度	内容
技术可行性	现有技术栈支持、架构变更需求
用户价值	解决问题深度、使用频率
竞品分析	类似产品实现方式
实现复杂度	工作量估算、风险点
依赖关系	前置功能、阻塞项

项目检查

bash

# 动态获取仓库
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

输出格式

markdown

## 调研报告

### 技术可行性
- **评级**: [高/中/低]
- **方案**: [简要描述]
- **影响**: [无影响/小改动/大重构]

### 用户价值
- **解决问题**: [描述]
- **目标用户**: [描述]
- **使用频率**: [高/中/低]

### 竞品分析
- **参考**: [产品名] - [实现方式]
- **提示**: 如需深度竞品分析，可先运行 `/product-insight [目标产品]`

### 复杂度
- **工作量**: [X 人周]
- **风险点**: [列举]
- **依赖项**: [列举]

### 相关调研
- [已有链接] (如存在)

阶段 3: 方案设计

方案要素

markdown

## 功能方案

### 功能边界
**包含**：[核心功能]
**不包含**：[未来扩展]

### 技术方案
**后端**：[API、数据模型]
**前端**：[页面、组件、路由]
**AI 代理**（如适用）：[代理、工具]

> 详见：REFERENCE.md#Agent 协同规则

### 风险与缓解
| 风险   | 影响       | 措施   |
| :----- | :--------- | :----- |
| [风险] | [高/中/低] | [措施] |

阶段 4: 迭代修订

markdown

## 方案草案（待确认）

[上述方案内容]

---

**请确认**：
1. 功能边界是否符合预期？
2. 有遗漏的细节吗？

回复："确认" / "修改 X"

阶段 5: Issue 创建

链接验证（必做）

bash

# 验证函数
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

markdown

## [类型] 功能标题

### 问题描述
[清晰描述问题]

### 解决方案

#### 功能范围
**包含**：[功能点]
**不包含**：[未来扩展]

#### 技术方案
**后端**：[API、数据模型]
**前端**：[页面、组件、i18n]
**AI 代理**：[代理、工具]

#### 参考资源
- [文档链接] (确保可访问)
- 📄 [调研报告](链接)

### 复杂度
- **工作量**: [X 人周]
- **风险**: [高/中/低]

### 验收标准
- [ ] `make check-all` 通过
- [ ] 已更新文档

### 依赖项
- [ ] 前置 Issue #xxx

---

调研时间: YYYY-MM-DD | 版本: v1.0

创建命令

bash

# 动态获取仓库
REPO=$(git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/')

# 创建 Issue
gh issue create --repo "$REPO" --title "[类型] 功能标题" --body "..."

阶段 6: 调研报告保存

报告文件

模板：@templates/research.md

bash

docs/research/{feature}-research.md

更新索引

更新 docs/research/README.md：

•添加文件到结构
•添加到分类表格

快捷操作

指令	行为
"继续"	下一阶段
"确认"	进入 Issue 创建
"修改 X"	修订指定部分
"重新调研"	返回阶段 2
"放弃"	终止

常用命令

bash

# 动态仓库
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 | 理念: 状态机驱动 + 元认知自检 + 运行时状态追踪

让每个创意都得到深度调研。