/omk-know

name: omk-know
description: "Capture knowledge into episodes.md. Trigger when user says 'remember', 'capture this', 'lesson learned', 'note this', '@know', or when preserving insights, corrections, or discoveries from the current conversation."
argument-hint: "[insight to capture]"
disable-model-invocation: true

Trigger Examples

• "@know macOS stat 用 -f 不用 -c"
• "记一下这个坑"
• "capture this lesson"
• "note: this API requires auth header"
• "@know HubSpot API 有 rate limit 100/10s"

Know — Knowledge Capture

Read the current conversation and capture an insight into knowledge/episodes.md.

Input

$ARGUMENTS

Process

1. If no input provided, ask user: "What insight should I capture?" 2. Extract: trigger scenario + DO/DON'T action + keywords 3. Check dedup: grep -iw keywords in knowledge/rules.md and knowledge/episodes.md

• Already in rules → tell user, skip
• Already in episodes → tell user count, suggest promotion if ≥3

4. Format: `DATE | active | KEYWORDS | SUMMARY` (≤80 chars, no | in summary) 5. Append to knowledge/episodes.md 6. Output: 📝 Captured → episodes.md: 'SUMMARY'

Rules

• Summary must contain actionable DO/DON'T, not narrative
• Keywords: 1-3 english technical terms, ≥4 chars each, comma-separated
• If episodes.md has ≥30 entries, warn user to clean up first