Skip to content

research-insight-log

Pack: research

研究灵感日志：记录“我突然想到”“记一下这个想法”的hypothesis/analogy/research-question/method-idea/experiment-idea等，绑定触发来源(source_ids/note_ids/context)、potential value与验证问题。Use when users ask to capture hunches/ideas not yet proven, for later validation instead of direct claims.

Compatibility: opencode

作用/Purpose

在研究过程中捕获灵感闪现、跨领域类比、未验证假设、研究缺口和潜在贡献点。这些想法尚未经过验证，但可能对研究方向、论文贡献、产品机会或规划判断有重要价值。通过结构化记录，避免灵感丢失，并为后续验证提供清晰路径。

触发场景/Trigger Scenarios

  • 用户说"我突然想到…"或"记一下这个想法"
  • Agent在阅读多个来源时发现跨源连接
  • 发现潜在研究缺口、论文贡献点、产品机会或规划判断
  • 某个概念可以迁移到另一领域
  • 用户希望保留一个想法但暂不展开

输入/Input

  • 用户口述的想法或Agent发现的连接
  • 触发来源：source_ids、note_ids、当前上下文
  • 想法分类提示（可选）

Insight types: analogy, hypothesis, research-question, method-idea, experiment-idea, product-opportunity, planning-judgment, contradiction, terminology, writing-angle

输出/Output

  • insight-log.jsonl — 结构化灵感记录（每行一条JSON）
  • idea-inbox.md — 人类可读的想法收件箱

工作流/Workflow

  1. 捕获灵感 — 用清晰标题记录核心想法
  2. 分类 — 确定 insight_type（analogy, hypothesis, research-question, method-idea, experiment-idea, product-opportunity, planning-judgment, contradiction, terminology, writing-angle）
  3. 记录触发来源 — 使用 trigger 对象记录 source_ids、note_ids、context
  4. 描述潜在价值 — 说明 potential_value（为什么这个想法可能重要）
  5. 列出验证问题 — needs_validation：要回答哪些问题才能确认/否定
  6. 列出可能产出 — possible_outputs：如果验证成功可以产出什么
  7. 设置状态 — status 设为 "open"

Schema

insight-log.jsonl 每行一个 JSON 对象，字段如下：

Required fields

  • insight_id (string): pattern INS-\d+
  • title (string): non-empty
  • insight_type (string): one of analogy, hypothesis, research-question, method-idea, experiment-idea, product-opportunity, planning-judgment, contradiction, terminology, writing-angle
  • content (string): non-empty
  • trigger (object): at least one of:
  • source_ids (list)
  • note_ids (list)
  • context (string)
  • potential_value (string)
  • needs_validation (list): non-empty
  • status (string): one of open, validated, rejected, merged
{"insight_id":"INS-12","title":"RAG retrieval drift may be index freshness bound","insight_type":"hypothesis","content":"Observed answer quality drops when index staleness exceeds one release cycle.","trigger":{"source_ids":["SRC-120045"],"note_ids":["NOTE-89"],"context":"Comparing two benchmark runs after weekly data sync"},"potential_value":"Can guide refresh cadence policy and reduce stale-answer incidents.","needs_validation":["Run ablation on refresh intervals","Control for prompt/version changes"],"status":"open"}

质量门禁/Quality Gates

  • 必须有标题（title）
  • 必须说明触发来源（source/notes/context至少一项）
  • 必须说明潜在价值（potential_value）
  • 必须列出至少1个验证问题（needs_validation）
  • 状态必须为：open, validated, rejected, merged
  • 灵感不能未经验证直接作为事实进入报告

... (15 more lines in full SKILL.md)