Communitygithub.com

124zhe/learn-a-domain

????????????????????????? Codex Skill

learn-a-domain とは?

learn-a-domain is a Codex agent skill that ????????????????????????? Codex Skill.

対応~Claude CodeCodex CLI~Cursor
npx skills add 124zhe/learn-a-domain

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

陌生领域快速入门

核心目标

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

  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. 叠加目标路径

按模式只读取一个文件:

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

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. 不确定性、风险边界和暂不学习项

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

资源导航

関連スキル