124zhe/learn-a-domain

陌生领域快速入门

核心目标

帮助小白在第一轮学习后做到：

1. 用自己的话解释领域是什么、解决什么问题。
2. 看懂主要分支和知识关系。
3. 理解关键基础概念。
4. 知道下一步先学什么、后学什么。
5. 判断是否值得继续深入。

始终先建立快速认知底座，再根据目标叠加项目成果或考试证书路径。不要直接堆资料，也不要先生成完整内容再补问目标。

工作流

严格按顺序执行以下阶段。

1. 动态收集输入

读取 intake-and-mode.md。收集以下六项：

• 学习目的
• 最终希望实现的效果
• 当前知识基础
• 可投入时间
• 已有资料
• 偏好的学习方式

复用用户已经提供的信息，不重复询问。缺少信息时每轮只补问 1 至 3 项；六项齐全后停止提问。

2. 判断并确认模式

从以下模式中选择一个：

• quick：快速认知
• project：快速认知 + 项目成果
• exam：快速认知 + 考试证书

向用户说明判断结果和一句理由，等待用户确认。未确认前不要生成完整地图、图片或网页。

3. 联网研究

每次都联网。先建立问题清单，再搜索并交叉核验：

• 稳定的领域骨架和基本概念
• 当前术语、规则、考纲或工具
• 中文入门资料和免费 B 站视频
• 权威核验来源

读取 sources-and-safety.md。把“适合小白学习的资料”和“用于事实核验的来源”分开。不要推荐大学或机构官方课程；可以使用其官方文件、论文、考纲或文档做事实核验。

4. 建立快速认知底座

读取 quick-cognition.md。先生成第一层精简地图：

• 根据领域复杂度动态决定模块数量，最多 8 个模块。
• 每个模块最多显示 4 个核心知识点。
• 展示知识点的包含、依赖、先后或对比关系。
• 第一层必须采用“中心主题 → 一级模块 → 具体知识点”的放射式思维导图，使用连续分支线表达从属关系；禁止用瀑布流卡片冒充知识地图。
• 更细内容放入模块的第二层地图。

每个知识点必须包含：一句话定义、通俗解释、为什么学、与其他知识点的关系、常见误解、理解检查问题和至少一个快速中文资料。

5. 叠加目标路径

按模式只读取一个文件：

• quick：继续使用 quick-cognition.md
• project：读取 project-mode.md
• exam：读取 exam-mode.md

把路线限制在用户的时间预算内。删除对目标没有直接帮助的内容，并明确列出“现在不用学什么”。

6. 生成三种交付物

读取 visual-and-web-output.md，使用同一份结构化数据生成：

1. 正式结构图：运行 scripts/render_formal_map.py，生成中心向左右展开的放射式思维导图，确保中文与关系准确。
2. Image2 美化图：必须直接调用可用的 Image2 / image generation 工具，不要只给提示词。
3. 本地网页：运行 scripts/build_web.py，生成可直接打开的单文件 index.html。

正式结构图是内容基准。检查 Image2 图片；如有错字或遗漏，最多重试两次，并明确以正式结构图为准。

7. 验收后交付

读取 quality-checklist.md。先运行：

python scripts/validate_delivery.py <delivery.json>
python scripts/render_formal_map.py <delivery.json> --output <knowledge-map.svg>
python scripts/build_web.py <delivery.json> --output <index.html>
python scripts/validate_artifacts.py --delivery <delivery.json> --formal-map <knowledge-map.svg> --beautified-map <image2-map.png> --web <index.html>

再用真实浏览器检查网页桌面端与 390px 手机端：可打开、可点击、页面本身无横向溢出、地图区域可缩放或横向查看、无文字遮挡。检查所有直达链接。任何强制交付物失败时，先修复；无法修复时明确说明，不要悄悄省略。

交付顺序

最终回复按以下顺序：

1. 当前模式、目标和完成标准
2. 正式知识图
3. Image2 美化图
4. 本地网页入口
5. 30 至 60 分钟快速认知顺序
6. 项目路径或考试路径（如适用）
7. 资料与来源说明
8. 不确定性、风险边界和暂不学习项

不要在对话中重复网页里的全部内容。先交付可打开的成果，再指出用户现在应该从哪个节点开始。

资源导航

• 数据结构：读取 delivery-schema.md
• 三类真实测试：读取 forward-tests.md
• 网页模板：使用 assets/web-template.html