signal-detector

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Signal Detector — Ambient Brain Capture

Signal Detector — 环境脑捕获工具

Lightweight sub-agent that fires on every inbound message to capture TWO things with EQUAL priority:
  1. Original thinking — the user's ideas, observations, theses, frameworks
  2. Entity mentions — people, companies, media references
Original thinking is AT LEAST as valuable as entity extraction. Ideas are the intellectual capital. Entities are bookkeeping. Both compound over time.
轻量型子Agent,针对每条传入消息触发,同等优先级捕获两类内容:
  1. 原创想法 — 用户的观点、观察结果、论点、框架
  2. 实体提及 — 人物、公司、媒体引用
原创想法的价值至少与实体提取相当。想法是智力资本,实体是记录项,两者都会随时间积累价值。

Contract

约定

This skill guarantees:
  • Fires on every message (no exceptions unless purely operational)
  • Runs in parallel (spawned, never blocks main response)
  • Captures ideas with the user's EXACT phrasing (no paraphrasing)
  • Detects entity mentions and creates/enriches brain pages
  • Logs a one-line summary of what was captured
  • Back-links all entity mentions (Iron Law)
  • Citations on every fact written
Convention: See
skills/conventions/quality.md
for Iron Law back-linking.
Every time this skill creates or updates a brain page that mentions a person or company:
  1. Check if that person/company has a brain page
  2. If yes → add a back-link FROM their page TO the page you just created/updated
  3. Format:
    - **YYYY-MM-DD** | Referenced in [page title](path) — brief context
  4. An unlinked mention is a broken brain.
本Skill保证:
  • 针对每条消息触发(纯操作类消息除外)
  • 并行运行(以子进程启动,绝不会阻塞主响应)
  • 完全保留用户的措辞捕获想法(不做改写)
  • 检测实体提及并创建/丰富脑页
  • 记录捕获内容的单行摘要
  • 所有实体提及均添加反向链接(铁律)
  • 所有写入的事实均附带引用
惯例: 关于铁律反向链接,请查看
skills/conventions/quality.md
每当本Skill创建或更新提及人物或公司的脑页时:
  1. 检查该人物/公司是否已有脑页
  2. 若已有 → 在其脑页中添加一条指向刚创建/更新页面的反向链接
  3. 格式:
    - **YYYY-MM-DD** | 参考自[页面标题](路径) — 简要上下文
  4. 未添加链接的提及会导致脑系统失效。

Phases

阶段

Phase 1: Idea/Observation Detection (PRIMARY)

阶段1:想法/观察结果检测(首要)

When the user expresses a novel thought, observation, thesis, or framework:
  • If it's the user's original thinking (they generated it) → create/update
    originals/{slug}
  • If it's a world concept they're referencing → create/update
    concepts/{slug}
  • If it's a product or business idea → create/update
    ideas/{slug}
Capture exact phrasing. The user's language IS the insight. Don't paraphrase.
Cross-linking (MANDATORY): Every original MUST link to related people, companies, meetings, and concepts. An original without cross-links is a dead original.
当用户表达新颖的想法、观察结果、论点或框架时:
  • 如果是用户的原创想法(由用户生成)→ 创建/更新
    originals/{slug}
  • 如果是用户引用的通用概念 → 创建/更新
    concepts/{slug}
  • 如果是产品或商业想法 → 创建/更新
    ideas/{slug}
完全保留措辞。 用户的语言本身就是洞察,请勿改写。
交叉链接(强制要求): 每个原创内容必须关联相关的人物、公司、会议和概念。未添加交叉链接的原创内容毫无价值。

Phase 2: Entity Detection (SECONDARY)

阶段2:实体检测(次要)

  1. Extract entity mentions (people, companies, media titles)
  2. For each entity:
    • gbrain search "name"
      — does a page exist?
    • If NO page → check notability. If notable, create page with enrichment.
    • If page exists but THIN → trigger enrich
    • If page exists and RICH → no action
  3. For new FACTS with specific dates → call
    gbrain timeline-add <slug> <date> "<summary>"
Auto-link (v0.10.1): When you write/update an originals or ideas page that references a person or company, the auto-link post-hook on
put_page
automatically creates the link from the new page to that entity. You don't need to call
gbrain link
manually. Timeline entries still need explicit calls.
  1. 提取实体提及(人物、公司、媒体标题)
  2. 针对每个实体:
    • 执行
      gbrain search "name"
      — 检查是否存在对应页面?
    • 页面 → 检查知名度。若具备知名度,则创建页面并补充内容。
    • 若页面存在但内容单薄 → 触发内容补充
    • 若页面存在且内容丰富 → 无需操作
  3. 对于带具体日期的新事实 → 调用
    gbrain timeline-add <slug> <date> "<summary>"
自动链接(v0.10.1): 当你撰写/更新提及人物或公司的originals或ideas页面时,
put_page
的自动链接后置钩子会自动创建从新页面到该实体的链接。无需手动调用
gbrain link
。时间线条目仍需显式调用。

Phase 3: Signal Logging

阶段3:信号日志

Always log a one-line summary:
  • Signals: 0 ideas, 0 entities, 0 facts (skipped: operational)
  • Signals: 1 idea (captured → originals/x), 2 entities (enriched → people/y, companies/z)
This makes the ambient capture loop debuggable.
始终记录单行摘要:
  • Signals: 0 ideas, 0 entities, 0 facts (skipped: operational)
  • Signals: 1 idea (captured → originals/x), 2 entities (enriched → people/y, companies/z)
这让环境捕获循环可调试。

Output Format

输出格式

No visible output to the user. This skill runs silently in the background. The output is brain pages created/updated and the signal log line.
对用户无可见输出。本Skill在后台静默运行。输出为创建/更新的脑页以及信号日志行。

Anti-Patterns

反模式

  • Blocking the main response to wait for signal detection to complete
  • Paraphrasing the user's original thinking instead of capturing exact phrasing
  • Creating pages for non-notable entities (one-off mentions)
  • Skipping back-links after creating/updating pages
  • Running on purely operational messages ("ok", "thanks", "do it")
  • 等待信号检测完成而阻塞主响应
  • 改写用户的原创想法而非保留原始措辞
  • 为非知名实体创建页面(一次性提及)
  • 创建/更新页面后跳过反向链接
  • 针对纯操作类消息运行(如“好的”、“谢谢”、“执行”)

Tools Used

使用的工具

  • search
    — check if entity page exists
  • query
    — semantic search for related context
  • get_page
    — load existing entity pages
  • put_page
    — create/update brain pages
  • add_link
    — cross-reference entities
  • add_timeline_entry
    — record events on entity timelines
  • search
    — 检查实体页面是否存在
  • query
    — 相关上下文的语义搜索
  • get_page
    — 加载现有实体页面
  • put_page
    — 创建/更新脑页
  • add_link
    — 实体交叉引用
  • add_timeline_entry
    — 在实体时间线记录事件