Knowledge Connector

Knowledge Connector should feel like a product line, not another graph utility.

Its job is not just to extract concepts. Its job is to help the user:

• import notes and documents with low friction
• search across multiple documents from one query
• visualize concept relationships in a way that is easy to inspect
• get actionable graph results such as what to connect, review, or expand next

What This Skill Optimizes For

Default toward five high-value outcomes:

• fast document import
• guided import onboarding
• cross-document knowledge retrieval
• relationship-aware graph views
• actionable next steps

Avoid drifting into “yet another adjacent knowledge skill”.

Primary Workflows

1. Import Experience

Use kc import-docs when the user wants to build a graph from multiple files or a notes directory. Use kc import-wizard when the user wants a preview-first onboarding flow.

Good import behavior means:

• accept files or a directory
• preserve source titles and paths
• show how many documents, concepts, and relations were created
• keep the user oriented after import

2. Cross-Document Search

Use kc search or kc query when the user asks:

• where an idea appears across notes
• which documents mention a concept
• what concepts connect several documents

Results should show:

• matching concepts
• matching source documents
• useful next actions

3. Relationship Visualization

Use kc visualize for full graph export and kc map for a concept-centered actionable subgraph.

Visualization should help the user answer:

• what is central
• what is weakly connected
• what deserves review

4. Actionable Results

Do not stop at “here is the graph”.

The output should usually recommend one or more actions such as:

• import more source material
• auto-connect newly imported concepts
• inspect a concept-centered subgraph
• verify weak relationships from source documents
• export a graph view for sharing or review

Core Commands

Import

kc import-wizard --dir notes/
kc import-docs --dir notes/
kc import-docs --files a.md b.md c.txt

Search

kc search "machine learning"
kc answer "哪些文档把强化学习和规划连在一起？"
kc query "transformer" --sources
kc query --ask "哪些文档同时提到了强化学习和规划？"

Map And Visualize

kc map --concept "人工智能" --depth 2
kc visualize --format html --output graph.html
kc visualize --concept "机器学习" --depth 2 --output ml-graph.html

Manage

kc stats
kc export --output backup.json
kc import --file backup.json

Output Standard

When the skill returns results, prefer this structure:

What Matched

Show concepts and source coverage.

Why It Matters

Explain the meaningful relationship or pattern.

Next Step

Tell the user what to do next with the graph.

Product Positioning

Knowledge Connector is strongest when the user has:

• a growing notes corpus
• repeated concepts spread across files
• a need to move from storage to understanding

It is weaker if it only acts like a raw extractor with no import flow, no source-aware search, and no next-step guidance.