Concept Forge
Concept Forge は、ユーザーの散発的な質問を永続的な概念資産に変えます。すなわち、簡潔な回答、構造化された知識カード、Quarkdown 形式の読み物原稿、Slidev 形式の発表資料、そして自己完結型のインタラクティブ HTML 解説ページです。
目的は単発の回答を作ることではありません。目的は、概念を覚えやすくし、再利用可能なローカル知識/HTML ライブラリを時間とともに育てることです。
コアループ
常に以下の順序に従ってください;
- 質問を正規化する:コア概念、別名、比較対象、ユーザーの意図を特定します。
- まず既存のエントリを検索する:
scripts/concept_forge.py lookupを使用。 - 深さを計画する:
scripts/concept_forge.py planまたはリサーチメソッドを使用し、Quick、Standard、Deep から選択。 - 再構築の前に再利用する:強力な一致があれば、既存の直接回答と HTML パスを返します。ユーザーが要求した場合、エントリが古くなっている場合、または概念が時間に敏感な場合にのみ更新します。
- 選択した深さで調査する(使用可能なエントリがない場合):後述の Concept Lens を使用し、トピックが変更されている可能性がある場合や正確な情報源が重要な場合はブラウジングも行います。
- 概念レコードを構造化 JSON として形成する:
references/concept-schema.mdに従います。 - レンダリングして保存する:
scripts/concept_forge.py upsertを使用。これにより、JSON、Quarkdown、Markdown、HTML、Slidev ソースの各成果物が作成される必要があります。 - 配信ブランチを確認する:ユーザーが正式な読み物、PDF、スライド、トーク、プレビュー、ビルド、エクスポートを要求した場合、
scripts/concept_forge.py bootstrap "<元のリクエスト>"を実行。 - バリデーションする:保存されたエントリと生成された成果物を
scripts/concept_forge.py validateで検証。 - 中国語で報告する:常に最初に回答を、次にローカル HTML パスを提示します。実装の詳細は、尋ねられない限り避けてください。
ユーザー向け応答形式
すべての完了したリクエストは、以下の2つをこの順序で返さなければなりません:
- 直接回答:ユーザーの質問に即座に答える、1~3文の短い中国語。記憶に役立つ場合は、鮮明な比喩を優先します。これは HTML を開く時間がないユーザーのために、単独で成立する必要があります。
- インタラクティブ HTML:生成または再利用された HTML 解説ページへのローカルパスまたはリンク。
以下のようなコンパクトな形式を使用します:
一句话说,Skill 像给 AI 准备的一本小手册:Prompt 是这次怎么做,Skill 是以后遇到同类任务都按这套做。
互动页:<path/to/html>
ユーザーが基本的な回答を得るために HTML を開く必要があってはなりません。
ワークスペース
デフォルトのワークスペース:
<カレントワーキングディレクトリ>/concept-forge-workspace
ユーザーが別の保存場所を指定した場合は、それを使用します。初回使用前に初期化します:
python <skill>/scripts/concept_forge.py init --workspace <workspace>
ワークスペースには以下が含まれます:
knowledge/index.json
knowledge/concepts/<slug>/concept.json
knowledge/concepts/<slug>/concept.qd
knowledge/concepts/<slug>/concept.md
knowledge/concepts/<slug>/sources.json
html/<slug>.html
slidev/<slug>/slides.md
slidev/<slug>/package.json
quarkdown/
assets/
config.json
Concept Lens(概念レンズ)
hv-analysis の精神を取り入れつつ、軽量で概念サイズに抑えます。
新しい概念または更新された概念ごとに、以下の層に答えます:
- 一行記憶:最も短く有用な定義。
- 直接回答:チャットですぐ使える説明。通常は短い段落1つで、必要に応じて比喩を含めます。
- それが何か:平易な言葉での説明。
- なぜ存在するか:どのような問題、混乱、ワークフロー、歴史的変化がそれを必要としたのか。
- どう機能するか:理解に必要な最小限の仕組み。
- それが何でないか:よくある誤解と境界線。
- 水平比較:よく混同される近隣の概念、ツール、プロンプト、ワークフロー、用語。
- 関連マップ:親概念、兄弟概念、子概念、前提条件、および次の質問。
- 例:具体的な日常シナリオを一つ。
- 記憶のフック:比喩、フレーズ、または視覚的なアンカーで記憶に定着させるもの。
- ミニクイズ:記憶を強化するための軽量な質問2~3問。
事実が最新、ニッチ、議論の余地がある、製品固有、または情報源に敏感な可能性がある場合は、ウェブ調査を使用します。公式ドキュメントと一次情報源を優先します。ブラウジングしない場合は、情報源を「モデル由来 / ユーザー提供 / ローカルコンテキスト」と正直にレコードに記載します。
出力モード
ブランチ選択
3つの成果物ブランチがあります。これらを正確に区別します。
- 通常概念ブランチ:ユーザーが「X 是什么」、「X 和 Y 有什么区别」、「帮我理解/记住/整理这个概念」と尋ねるか、キーワードを指定した場合。直接回答、Quarkdown ソース、Slidev ソース、HTML、インデックスを生成します。Quarkdown や Slidev のインストールを促さないでください。
- フォーマルリーディングブランチ:ユーザーが「正式阅读」、「长文档」、「报告」、「PDF」、「文档」、「打印」、「编译」、「导出」、「交付」と要求するか、明示的に Quarkdown を指定した場合。コンパイル前に
bootstrapを実行します。Quarkdown がない場合は、コンパイル/エクスポートの前に停止し、インストール手順を表示します。 - フォーマルプレゼンテーションブランチ:ユーザーが「演示」、「公开讲解」、「课件」、「幻灯片」、「PPT」、「slides」、「deck」、「presentation」、「预览」、「构建」、「导出」と要求するか、明示的に Slidev を指定した場合。プレビュー/ビルド/エクスポートの前に
bootstrapを実行します。Node/npm または Slidev プロジェクトの依存関係がない場合は、プレビュー/ビルド/エクスポートの前に停止し、セットアップ手順を表示します。
ユーザーがリーディングとプレゼンテーションの両方を要求した場合は、Quarkdown をマザー原稿として、Slidev を派生トーク原稿として使用し、両方のブランチをチェックします。
ブランチヘルパーコマンド:
python <skill>/scripts/concept_forge.py --workspace <workspace> plan "<元のリクエスト>"
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap "<元のリクエスト>"
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap --intent quarkdown
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap --intent slidev
python <skill>/scripts/concept_forge.py --workspace <workspace> bootstrap --intent all
既存エントリ
検索で強力な既存エントリが見つかった場合:
- 既に存在することを伝えます。
direct_answerが存在する場合はそこから短い回答を、存在しない場合はsummaryとmemory_hookを使用します。- ローカル HTML ページにリンクします。
- 有用な場合にのみ更新可能な項目を提案します。デフォルトでは再構築しません。
新規エントリ
新しい概念の場合:
references/concept-schema.mdに従って JSON レコードを作成します。- 少なくとも以下を含めます:title、aliases、depth、direct answer、summary、what、why、not、comparisons、related、memory hook、quiz、sources。
- 以下を実行します:
python <skill>/scripts/concept_forge.py upsert --workspace <workspace> --input <concept.json>
python <skill>/scripts/concept_forge.py validate --workspace <workspace> --slug <slug>
- 最初に直接回答を、次に生成された HTML パスを返します。Quarkdown や Slidev のパスについては、ユーザーがファイル、読み物原稿、トーク、エクスポート、デバッグを要求した場合にのみ言及します。
更新
以下の場合にのみ更新します:
- ユーザーが更新/やり直し/拡張を依頼した時;
- エントリの経過日数が
refresh_policy.daysを超えた時; - トピックが最新または急速に変化している時;
- 情報源が弱い、または不足している時;
- ユーザーがより具体的なフォローアップ質問をし、それが概念の境界を変更する時。
更新する際は、既存の別名や関連リンクを、明らかに誤りでない限り保持します。
HTML 要件
正確な成果物の形状については references/html-explainer.md を使用します。
生成されるページは自己完結型であり、以下を含む必要があります:
- ヒーロー定義;
- 「何か / なぜ / 何でないか」セクション;
- 比較カード;
- 関連概念マップ;
- 有用な場合のタイムラインまたは起源ストリップ;
- インタラクティブな表示カード;
- ミニクイズ;
- 「覚えておくべき3つのこと」;
- 情報源/更新フッター。
ページはチャットのトランスクリプトなしでも理解できる必要があります。
ファーストクラスの Quarkdown と Slidev
Quarkdown と Slidev は成果物の形状の一部です。
- 常に
concept.qdを Quarkdown マザー原稿として生成します。これは知識ベースの標準的な読み物ドキュメントです。 - 常に
slidev/<slug>/slides.mdを発表原稿として生成します。これは概念レコードとマザー原稿から抽出されます。 - 常に
html/<slug>.htmlを高速なインタラクティブ記憶サーフェスとして生成します。 - 動的深度を使用して、調査、情報源、洗練の度合いを決定します:
- Quick:安定した小さな概念。すべてのソース成果物を生成しますが、通常はコンパイル/エクスポートをスキップします。
- Standard:ツール、メソッド、比較、「X 是什么」のデフォルト。すべての成果物を生成し、構造を検証します。
- Deep:ユーザーが調査を要求した場合、またはトピックが最新/複雑な場合。情報源、歴史、水平比較、トーク構造を強化します。
- Quarkdown のコンパイルや Slidev のビルド/エクスポートは、リクエストがフォーマルブランチに入った場合にのみ実行します。ソース生成は CLI がインストールされていることに依存してはなりません。
- 初回使用時に
scripts/concept_forge.py doctorを使用して一般的な環境チェックを行います。 - フォーマルなコンパイル/エクスポートの前に
scripts/concept_forge.py bootstrap "<元のリクエスト>"を使用して、インストール手順を案内するかどうかを判断します。 - Quarkdown フォーマルリーディングには、
quarkdownが必要です。Windows で不足している場合は、以下を表示します:irm https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/refs/heads/main/install.ps1 | iex、その後quarkdown doctor get install-dirで確認します。 - Quarkdown コンパイルには、
quarkdownが利用可能な場合、quarkdown c <concept.qd> --strict --out <verify-dir>を実行します。 - Slidev フォーマルプレゼンテーションには、Node と npm または pnpm が必要です。
slidev/<slug>でnpm installまたはpnpm installを実行し、その後必要に応じてnpm run dev、npm run build、またはnpm run exportを実行します。 - Slidev の PDF/PPTX エクスポートには、生成されたスライドプロジェクトに最初に
playwright-chromiumをインストールします:npm i -D playwright-chromium。
品質ゲート
完了を報告する前に、以下を確認します:
- 作成前に検索が試みられたこと;
- 最終応答に直接回答と HTML パスの両方が含まれていること;
- 概念に明確な一行記憶があること;
- 近隣の概念と誤解がカバーされていること;
- HTML が存在し、空でないこと;
- Quarkdown マザー原稿が存在すること;
- Slidev ソースが存在すること;
- フォーマルブランチがコンパイル/エクスポートの前に
bootstrapを実行したこと; - 不足しているフォーマルツールがコンパイル/エクスポートを試みる前に報告されたこと;
validateが合格すること;- インデックスに title、aliases、slug、direct answer、summary、Quarkdown パス、Slidev パス、HTML パスが含まれていること;
- 最終回答が短く、中国語で、ユーザー向けであること。
リファレンス
references/concept-schema.md:JSON および Markdown レコードの形状。references/research-method.md:軽量 hv-analysis の適応。references/html-explainer.md:インタラクティブ HTML 成果物の仕様。