knowledge-wiki-concept

Knowledge Wiki Concept

Create or update concept articles in Wiki/Concepts/ by extracting concepts from summary files that have been updated since the last run.

Steps

1. Establish the working directory

The knowledge base root is the Git repository root. Run git rev-parse --show-toplevel and store the result as KNOWLEDGE_PATH.

Use KNOWLEDGE_PATH for all subsequent steps.

2. Find summary files to process

Run:

node {KNOWLEDGE_PATH}/scripts/wiki/wiki-state.mjs find-unprocessed-summaries knowledge-wiki-concept

This outputs a JSON array of summary file paths (relative to KNOWLEDGE_PATH) that are new or updated since the last run. Example:

[
  "Wiki/Summaries/Posts/Alexa, tell me a joke..summary.md",
  "Wiki/Summaries/Posts/Vision Pro 使用体验（Part 1）.summary.md"
]

If the array is empty, print Nothing to process. and stop.

3. Process each summary file

For each path in the array from step 2, run the following sub-steps.

---

3a. Read the summary file

Read the summary file using the Read tool.

Parse the ## Key Concepts section. Each line has the form:

- [[Wiki/Concepts/{concept-slug}|{Display Name}]] — {description}

Extract the slug, display name, and description for each concept.

Also note the summary file's tags frontmatter field — you may draw on these when choosing concept tags, but only include tags that are genuinely relevant to the concept itself.

Derive the summary's link-path by stripping the .md extension from the summary file path, and store it as {summary-link-path}. Example: Wiki/Summaries/Posts/foo.summary.md → Wiki/Summaries/Posts/foo.summary

---

3b. For each concept, create or update its file

If the concept file does NOT exist, create it:

1. Run:

   node {KNOWLEDGE_PATH}/scripts/wiki/wiki-concept.mjs create "{concept-slug}" "{Display Name}"
   

   This creates Wiki/Concepts/{concept-slug}.md with frontmatter and an empty ## Sources section. The command prints the file path.