# Idea Researcher > 创意调研与功能创设助手 v3.1 - DivineSense 项目深度理解，6 阶段调研流程，生成规范 GitHub Issue Use when this capability is needed. - Skill: `tomevault-io/idea-researcher` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/idea-researcher` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/idea-researcher/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/idea-researcher --- # 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: 理解与扩展 ### 启动问题 1. **需求澄清**：解决什么痛点？目标用户？使用场景？ 2. **可能性扩展**：如何扩展？与现有功能的协同？ 3. **探索性问题**：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`： 1. 添加文件到结构 2. 添加到分类表格 --- ## 快捷操作 | 指令 | 行为 | | :--------- | :-------------- | | "继续" | 下一阶段 | | "确认" | 进入 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 | **理念**: 状态机驱动 + 元认知自检 + 运行时状态追踪 **让每个创意都得到深度调研。** --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/hrygo) — claim your Tome and manage your conversions.