concept-atlas-dense-explain 0.1.0

package/skill/assets/template/vite.config.js

@@ -0,0 +1,21 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import mdx from '@mdx-js/rollup';
+import { viteSingleFile } from 'vite-plugin-singlefile';
+
+export default defineConfig({
+  plugins: [
+    {
+      enforce: 'pre',
+      ...mdx({
+        providerImportSource: null,
+      }),
+    },
+    react(),
+    viteSingleFile(),
+  ],
+  build: {
+    outDir: 'dist',
+    emptyOutDir: true,
+  },
+});

package/skill/references/components.md

@@ -0,0 +1,27 @@
+# Component contract
+
+## Structure
+
+```mdx
+<ExplainPage id="topic" title="..." summary="...">
+  <ConceptGraph root="root">
+    <ConceptNode id="root" title="..." level="L0" summary="...">
+      <Definition>...</Definition>
+      <Input>...</Input><Output>...</Output>
+      <Children><ConceptRef id="child" /></Children>
+    </ConceptNode>
+    <ConceptNode id="child" title="..." level="L1" parent="root">...</ConceptNode>
+    <Relation from="child" to="other" type="depends-on" label="依赖" />
+  </ConceptGraph>
+</ExplainPage>
+```
+
+Supported semantic content includes `Overview`, `Definition`, `Mechanism`, `Implementation`, `Example`, `Counterexample`, `Boundary`, `Prerequisite`, `Input`, `Output`, and `Glossary`.
+
+High-value verification components: `LearningObjectives`, `KeyQuestion`, `Evidence(command, observes)`, `Invariant(title)`, `FailureMode(symptom, cause, evidence, remedy)`, and `Tradeoff(options)`.
+
+Presentation components: `Stack`, `Grid`, `Split`, `Tabs`, `Flow`, `Compare`, `DecisionMatrix`, `Timeline`, `Callout`, `Details`, `RelationMap`, `RelationPath`, `Insight`, and `NoteGrid`.
+
+## Request priorities
+
+The portable template covers the core `req.md` contract, node exploration, graph view, semantic relations, search, level/relation filters, URL node state, browsing history, keyboard shortcuts, Mermaid zoom, and responsive rendering. Evidence-oriented components and compact tradeoffs cover the highest-value `request.md` enhancements without adding permanent side panels.

package/skill/references/prompting.md

@@ -0,0 +1,38 @@
+# AI prompt guide
+
+Include this contract when asking an AI to generate or revise a dense explanation:
+
+```text
+输出语义 MDX，不要输出 CSS、HTML 布局、坐标、SVG 或交互脚本。
+先给一个 L0 根节点，再用 L1/L2/L3/L4 表达结构、机制、实现细节和边界。
+父子层级使用 parent/Children；跨分支含义使用 Relation。
+每个关键节点优先提供：summary、Definition、Input/Output、Mechanism、一个 Example，以及 Evidence 或 Boundary。
+只在确实有帮助时使用组件：Flow 表示顺序，Compare/Tradeoff 表示选择，Timeline 表示时间，Evidence 表示验证，Invariant 表示必须保持的条件，FailureMode 表示故障定位。
+首屏只保留核心结论和 3–5 个关键事实；次要解释放进 Details。不要为了“看起来丰富”堆卡片。
+```
+
+## Component selection
+
+| Information shape | Component |
+| --- | --- |
+| 顺序、阶段、因果链 | `Flow` / `RelationPath` |
+| 两到四个对象的同维度比较 | `Compare` |
+| 方案、收益、代价、适用条件 | `Tradeoff` / `DecisionMatrix` |
+| 时间先后 | `Timeline` |
+| 可执行命令和观察结果 | `Evidence` |
+| 必须保持的条件 | `Invariant` |
+| 症状到原因和修复 | `FailureMode` |
+| 次要细节或长解释 | `Details` |
+
+Avoid using more than one primary presentation component in a single node unless the information shapes are genuinely different. Prefer short prose around one useful visual structure over a stack of decorative blocks.
+
+## Minimal generation skeleton
+
+```mdx
+<ConceptNode id="mechanism" title="机制" level="L2" parent="structure" summary="一句话结论">
+  <Definition>它是什么，以及为什么重要。</Definition>
+  <Mechanism>输入 → 转换 → 输出。</Mechanism>
+  <Evidence command="tool --inspect target" observes="验证哪个不变量或产物。" />
+  <Boundary>何时不成立，或哪些实现细节会改变结论。</Boundary>
+</ConceptNode>
+```