memory-research

记忆研究

研究外部主题，综合所得信息，并在用户批准后创建结构化的 Basic Memory 实体。

工作流

第 1 步：网络研究

Basic Memory 不包含网络搜索工具。如果当前宿主已有此类工具，请使用它。如果没有，用户可以添加任意网络搜索工具或 MCP 服务，例如 Parallel Search MCP。搜索查询会发送给相应提供方，因此请勿在查询中包含私人笔记内容。保存笔记前仍须征求用户同意。

跨多个来源搜索最新信息。建议进行 3-5 次搜索，以全面了解情况：

[subject name] site
[subject name] overview
[subject name] news [current year]
[subject name] [relevant domain keywords]

按实体类型收集的信息：

实体类型	关键信息
组织	业务内容、产品／服务、发展阶段（初创／成长／上市）、融资、领导团队、总部、员工人数、重要合作关系或合同
人物	当前职位、所属组织、背景、专业领域、重要工作、公开影响力
技术	功能、维护者、成熟度、生态系统、替代方案、采用情况
主题／领域	定义、现状、主要参与者、趋势、与用户背景的相关性

第 2 步：检查现有知识

在提出创建新实体之前，先搜索 Basic Memory：

bm_search(query="Acme Corp")
bm_search(query="acme")

尝试不同名称形式，包括全名、简称、首字母缩写和域名。

如果实体已存在：

• 汇报在 Basic Memory 中找到的内容，并结合网络研究结果
• 提议将新信息更新到现有笔记中
• 使用 bm_edit 追加新观察或更新过时内容

如果实体不存在，则继续评估。

第 3 步：评估并总结

以结构化摘要呈现研究结果。按部分整理并包含所有相关信息：

## [Subject Name]

**Type:** [Organization / Person / Technology / Topic]

**Summary:** [2-4 sentences: what this is, why it matters, key distinguishing facts]

**Key Details:**
- [Organized by what's relevant for the entity type]
- [Stage, funding, leadership for orgs]
- [Role, expertise, affiliations for people]
- [Maturity, ecosystem, alternatives for tech]

**Relevance:** [Why this matters to the user — connection to their work, domain, or interests.
If no obvious connection: "No specific connection identified."]

**Sources:**
- [URLs of key sources consulted]

评估指南

使用审慎措辞。 网络研究反映的是某一时点的信息，并非绝对事实：

• 使用“似乎是”“根据公开信息”“估计”等措辞
• 使用“截至［日期］”“根据［来源］”等表述
• 在观察记录中注明信息截至日期，以便之后按日期搜索时能够找到（参见 memory-notes）：- [stage] @valid:2026-10 Series B, about 200 employees (public information)
• 除非引用一手来源，否则融资金额、员工人数或营收不得写成确切数字

不要捏造信息。 如果无法找到某项信息，请如实说明：

• “领导团队信息未公开”
• “融资详情未披露”

让用户决定相关性。 不要强加固定的评估框架，而应突出事实，让用户自行得出结论。如果用户有特定的评估标准（战略契合度、买入／合作／竞争等），他们会告知你——收到要求后再应用。

第 4 步：提议创建实体

呈现摘要后，征求用户批准：

Create Basic Memory entity for [Subject]?
  Location: [suggested-folder]/[entity-name].md
  Type: [entity type]

  [yes / no / modify]

如果用户在请求中提供了背景信息（例如“在会议上见过他们”），请将该背景信息纳入拟创建的实体。

第 5 步：创建实体

获得批准后，创建结构化笔记。根据实体类型调整模板：

组织

bm_write(
  title="Acme Corp",
  directory="organizations",
  note_type="organization",
  tags=["organization", "relevant-tags"],
  content="""# Acme Corp

## Overview
[2-3 sentence description from research]

## Products & Services
- [Key offerings discovered in research]

## Background
**Stage:** [Startup / Growth / Public]
**Headquarters:** [Location]
**Employees:** [Estimate, hedged]
**Leadership:** [Key people if found]
**Founded:** [Year if found]

## Observations
- [relevance] Why this entity matters in user's context
- [source] Researched on YYYY-MM-DD
- [additional observations from research findings]

## Relations
- [Link to related entities already in the knowledge graph]"""
)

人物

bm_write(
  title="Jane Smith",
  directory="people",
  note_type="person",
  tags=["person", "relevant-tags"],
  content="""# Jane Smith

## Overview
[Current role and affiliation. Brief background.]

## Background
**Role:** [Title at Organization]
**Expertise:** [Key domains]
**Notable:** [Publications, talks, projects if found]

## Observations
- [role] Title at Organization
- [expertise] Key technical or domain expertise
- [source] Researched on YYYY-MM-DD

## Relations
- works_at [[Organization]]"""
)

技术

bm_write(
  title="Technology Name",
  directory="concepts",
  note_type="concept",
  tags=["concept", "technology", "relevant-tags"],
  content="""# Technology Name

## Overview
[What it is and what problem it solves]

## Key Details
**Maintained by:** [Organization or community]
**Maturity:** [Experimental / Stable / Mature]
**License:** [If applicable]
**Alternatives:** [Comparable tools or approaches]

## Observations
- [definition] What this technology does in one sentence
- [maturity] Current state and adoption level
- [source] Researched on YYYY-MM-DD

## Relations
- [Link to related concepts, tools, or projects in the knowledge graph]"""
)

可灵活调整这些模板。关键要素包括：note_type/tags 参数、概览、结构化详情、带类别的观察记录以及关系。

如果 bm_write 报告了类似的现有笔记，请确认其中是否有该实体的笔记，再决定是否保留新笔记；应合并或建立链接，而不是创建重复笔记。

第 6 步：保存背景信息

如果用户在请求中提供了背景信息，请将其记录到实体中：

# User said: "Acme Corp — saw their demo at the conference last week"
bm_edit(
  identifier="Acme Corp",
  command="insert_after_section",
  section="Observations",
  content="- [context] Saw their demo at conference, week of 2026-02-17"
)

这类背景信息往往最有价值——它体现了用户与该实体的关系，而网络研究无法提供这一点。

指南

• 始终进行网页搜索。 不要只依赖训练数据。研究应反映当前且可验证的信息。
• 先搜索 Basic Memory。 创建新实体前，先检查是否已有相关实体。更新现有实体，而不是重复创建。
• 对不确定的信息使用保留措辞。 对估算、未经证实的说法和推断出的细节使用限定语。
• 保存来源 URL。 在观察记录或「来源」部分中包含你查阅的 URL，以便用户核实并深入了解。
• 创建前先征求批准。 展示你的发现，让用户决定是否创建该实体以及要包含哪些内容。
• 记录用户背景。 如果用户说明了研究原因（例如在会议上认识、正在评估供应商等），应将此背景纳入实体。
• 不要过度研究。 通常进行 3-5 次网页搜索就足够了。目标是创建有用的知识图谱条目，而不是详尽的报告。
• 关联现有知识。 将新实体与知识图谱中已有的内容关联起来。关联越多，价值越大。