Concept Forge

Concept Forge 是一个通用的 AI Agent Skill：把你随口问出的概念、关键词、陌生名词或比较问题，转成可沉淀、可复用的个人知识资产。

它不绑定任何一家 Agent——只要你的 AI 助手支持 SKILL.md 形式的技能（Codex、Claude Code、Miaoclaw 等都可以），或者你愿意直接用命令行，都能用。

它的核心输出不是一段一次性回答，而是一套可以沉淀和复用的内容：

• 一句直接解释：先让你立刻听懂。
• Quarkdown 母稿：作为统一、可长期维护的知识库文本。
• 互动 HTML：适合快速复习、记忆和分享。
• Slidev 演示稿源码：适合公开讲解或二次整理成演示。
• JSON 索引：让同一问题下次直接复用，不重复劳动。

Skill 描述

将日常问题、概念、关键词、陌生术语，以及“X 是什么 / X 和 Y 有什么区别”这类请求，转换为中文知识卡片、Quarkdown 母稿、Slidev 演示稿源码和互动 HTML 解释页。适合碎片化知识整理、概念记忆、工具理解、术语对比、个人知识库沉淀和可复用学习材料生成。

关键词

概念解释、知识卡片、互动 HTML、Quarkdown、Slidev、知识库、个人知识库、概念地图、术语对比、AI 学习助手、碎片知识整理、Prompt 对比、工具解释、横纵分析、轻量研究、记忆钩子、复用索引、中文知识管理、学习页面、演示稿生成。

安装

把仓库放进你所用 Agent 的 skills 目录即可，重启后 Skill 会出现在可用技能中。

Codex：

git clone https://github.com/FeixueCode/concept-forge.git "$env:USERPROFILE\.codex\skills\concept-forge"

Claude Code：

git clone https://github.com/FeixueCode/concept-forge.git "$env:USERPROFILE\.claude\skills\concept-forge"

其他支持 SKILL.md 的 Agent：克隆到它的 skills 目录即可（技能入口就是仓库根部的 SKILL.md）。

不接任何 Agent 也可以：脚本本身是独立的 Python CLI（只依赖标准库），见下文“分支入口”。

使用方式

在你的 Agent 里直接提问即可，例如：

Harness 工程是什么
Skill 和 Prompt 有什么区别
Obsidian 是什么，适合什么人
RAG 和 Agent 的区别

分支入口

普通概念问题会走“普通解释分支”：生成一句解释、Quarkdown 源文件、Slidev 源文件、互动 HTML 和索引，但不打扰用户安装额外工具。

python scripts/concept_forge.py --workspace ./concept-forge-workspace plan "Harness 工程是什么"

如果用户明确要正式阅读、报告、PDF、文档、编译或 Quarkdown，会走“正式阅读分支”，并先检查 Quarkdown：

python scripts/concept_forge.py --workspace ./concept-forge-workspace bootstrap "把 Harness 工程整理成正式报告 PDF"

如果用户明确要演示、公开讲解、课件、PPT、slides、preview、build、export 或 Slidev，会走“正式演示分支”，并先检查 Node/npm 和 Slidev 项目依赖：

python scripts/concept_forge.py --workspace ./concept-forge-workspace bootstrap "把 Harness 工程做成公开讲解用的 Slidev 演示稿"

推荐默认工作目录：

<当前工作目录>/concept-forge-workspace

第一次使用时初始化：

python scripts/concept_forge.py init --workspace ./concept-forge-workspace

测试示例：

python scripts/concept_forge.py --workspace ./concept-forge-workspace demo
python scripts/concept_forge.py --workspace ./concept-forge-workspace validate --slug agent-skill
python scripts/concept_forge.py --workspace ./concept-forge-workspace lookup "Skill 是什么"

产物结构

concept-forge-workspace/
  knowledge/
    index.json
    concepts/<slug>/
      concept.json
      concept.qd
      concept.md
      sources.json
  html/<slug>.html
  slidev/<slug>/slides.md
  slidev/<slug>/package.json

工具依赖

基础生成只需要 Python 标准库。

Quarkdown 和 Slidev 是正式产物格式的一部分，但命令行工具只在“编译、预览、导出”时需要：

• Quarkdown：用于把 concept.qd 编译成正式阅读页或 PDF。
• Slidev：用于把 slides.md 预览、构建或导出演示稿。

检查环境：

python scripts/concept_forge.py doctor

文档

• docs/PRD.md：产品需求文档。
• docs/DESIGN.md：设计思路与系统逻辑。
• docs/KEYWORDS.md：技能描述、触发词和关键词。
• examples/harness-engineering/：一次真实测试产物。