Liuziyu77/AnythingAtlas
GitHub: Liuziyu77/AnythingAtlas
AnythingAtlas 是一个兼容主流 AI Agent 的学习路径规划技能插件,能将任意陌生主题转化为包含精选资源和分阶段路线图的个性化学习图谱。
Stars: 168 | Forks: 20
AnythingAtlas
规划任何主题的最佳学习路径
English · 简体中文
## 🧭 什么是 AnythingAtlas?
AnythingAtlas 是一个 Agent Skill,专为踏入陌生领域的第一步而设计。你可以将它与 Claude Code、Codex 以及其他兼容 Agent Skills 的框架配合使用。
当你开始学习一个新领域或面对一个陌生的主题时,最困难的往往不是寻找信息。而是弄清楚什么才是真正重要的,哪些资源值得你花时间,以及应该从哪里开始。
无论你是想进入量化金融领域、研究 AI agents、了解一个历史事件,还是掌握一项实用技能,AnythingAtlas 都能将散落的书籍、课程、论文、专家资料、档案、代码库和网络杂音转化为该领域的清晰图谱:包括其基础知识、值得学习的资源、如何使用这些资源,以及一份带你从初学者走向高阶的循序渐进的计划。
## 🚀 如何使用
**你所需要做的仅仅是告诉 AnythingAtlas 你想学什么,以及你有多少时间。它会通过一系列有针对性的问题引导你,广泛搜索精心挑选的学习资源,并围绕你的需求制定个性化的学习计划。**
### 🖼️ 示例库
三个领域,三个学习目标,三个视觉主题。选择一个封面即可打开完整且独立自包含的 HTML 图谱。
🎼 Learning to Hear Classical Music
Scholar · 24 weeks · Listening first
Build from musical language, periods, and representative works to comparing interpretations.
Explore the atlas →
|
🖼️ Impressionism for Museum Visitors
Archive · 8 weeks · Museum ready
Learn to read light, color, brushwork, subject, and composition while looking at art.
Explore the atlas →
|
📷 Portrait Photography Portfolio
Workshop · 8 weeks · Portfolio first
Move from exposure, focus, and natural light to a coherent series of 8–12 portraits.
Explore the atlas →
|
## 🚀 快速开始
AnythingAtlas 遵循开放的 [Agent Skills](https://agentskills.io/) 格式。相同的 `SKILL.md` 适用于 Codex、Claude Code 和其他兼容 Agent Skills 的客户端;核心工作流无需为每个平台重写。
代码库名为 `AnythingAtlas`;`anything-atlas` 是 `SKILL.md` 中的 skill 标识符,也是推荐的安装目录名。
| Agent | 用户级位置 | 项目级位置 | 显式调用方式 |
| --- | --- | --- | --- |
| [Codex](https://learn.chatgpt.com/docs/build-skills) | `~/.agents/skills/anything-atlas` | `
/.agents/skills/anything-atlas` | `$anything-atlas` |
| [Claude Code](https://code.claude.com/docs/en/skills) | `~/.claude/skills/anything-atlas` | `/.claude/skills/anything-atlas` | `/anything-atlas` |
| 其他兼容 Agent Skills 的客户端 | 遵循客户端文档 | 遵循客户端文档 | 视客户端而定 |
为 Codex 安装:
```
mkdir -p ~/.agents/skills
git clone https://github.com/Liuziyu77/AnythingAtlas.git ~/.agents/skills/anything-atlas
```
为 Claude Code 安装:
```
mkdir -p ~/.claude/skills
git clone https://github.com/Liuziyu77/AnythingAtlas.git ~/.claude/skills/anything-atlas
```
如果你已经克隆了 `AnythingAtlas`,请将该检出内容复制或符号链接到相应目录中。然后显式调用它,或者自然地描述你的目标,让 agent 从其 `description` 中匹配该 skill:
```
Codex: $anything-atlas
Claude Code: /anything-atlas
I want to understand modern AI agents well enough to propose a research
project. I know basic Python and language models, can study eight hours
per week for twelve weeks, and prefer papers, code, and explanations in
Chinese.
```
如果缺少重要信息,AnythingAtlas 会在进行研究之前提出一组简明的后续问题。
根据包含的示例构建两份交付物:
```
python3 scripts/build_atlas.py \
--input examples/sample-atlas.json \
--output-dir /tmp/anything-atlas-output \
--theme workshop
```
可用的主题有 `atlas`、`scholar`、`archive`、`signal` 和 `workshop`。CLI 的 `--theme` 会覆盖 JSON 模型中的 `meta.theme`;如果两者均未设置,则使用 `atlas`。
运行结构性回归测试套件:
```
python3 -m unittest discover -s tests -v
```
## 📦 产出契约
每次完整运行都会创建:
1. `anything-atlas-.md` — 一份结构化、可移植、可编辑的图谱。
2. `anything-atlas-.html` — 一份设计精良的独立演示文稿。
这两个文件都使用相同的精简五部分结构:确认后的需求简报、核心
指南、带有适合用户路径的精选资源、详细路线图,以及最后
按渠道分组的来源目录。在路径或路线图中分配的资源在 Markdown 和 HTML 中均可点击。
## 🎨 HTML 主题
AnythingAtlas 会根据主题选择视觉主题,或者用户可以自行选择。所有五个主题共享相同的内容和语义结构,并支持移动端、打印和离线使用。
| 主题 | 最适合 | 视觉方向 |
| --- | --- | --- |
| `atlas` | 跨学科、混合或未分类的主题 | 清晰的地图层级和蓝色信息卡片;默认主题 |
| `scholar` | 成熟学科、理论和学术综合 | 温暖的排版和类纸质的长篇阅读流 |
| `archive` | 历史、人物、组织和一手资料研究 | 档案卷宗风格、克制的棕褐色调以及文档提示线索 |
| `signal` | AI、软件、前沿技术和快速发展的研究 | 深色高对比度界面,突出显示版本、证据和技术信号 |
| `workshop` | 实用技能、基于项目的学习和实操训练 | 粗体模块和检查点,强调任务、产出和进度 |
生成的 HTML 不使用图像 logo。它会在页脚以文本形式注明一次 `AnythingAtlas`。
## 🗺️ 工作原理
```
Initial request: the topic and the time available
↓
Focused clarification and confirmed brief: guided questions to understand the learner and their needs
↓
Compact core guide: answer the real question, map concrete options, and give the first action
↓
Topic classification, discovery, verification, ranking, and curation
↓
Clickable user-fit resource tracks and a detailed personalized roadmap
↓
Channel-grouped source directory: official sites, books, YouTube, Bilibili, repositories, and other relevant channels
↓
Output: Markdown file + polished, self-contained HTML file
```
AnythingAtlas 会根据主题类型改变其资源选择、信息渠道和验证优先级:
| 主题类型 | 优先资源 | 主要信息渠道 | 核心评估标准 |
| --- | --- | --- | --- |
| 成熟学术领域 | 教科书、综述论文、大学课程、专业标准 | 图书馆目录、学术索引、大学课程页面、专业学会 | 经典地位、学术共识、系统性覆盖 |
| 快速发展的技术 | 最新论文、技术报告、源代码、基准测试 | 预印本服务器、会议论文集、官方代码库、研究实验室、专家简报 | 时效性、可复现性、维护活跃度 |
| 历史事件 | 一手文献、档案、口述历史、学术专著 | 国家和地方档案馆、图书馆馆藏、博物馆、学术数据库 | 出处、历史背景、事实与解读的分离 |
| 人物或组织 | 访谈、演讲、机构记录、传记、可信报道 | 官方网站、机构档案、访谈合集、新闻数据库 | 第一方记录与外部验证、年表、利益冲突 |
| 行业研究 | 官方统计、监管文件、企业披露、研究报告 | 监管数据库、统计门户、公司备案文件、行业协会、专业出版物 | 数据定义、利益冲突、时效性 |
| 实用技能 | 官方文档、演示、结构化课程、实践项目 | 官方文档网站、课程平台、项目代码库、从业者社区 | 实用性、难度递进、实践与反馈的质量 |
| 社会问题 | 官方数据、系统性研究、政策文件、多方观点 | 公共机构、综述数据库、研究中心、方法论透明的民间组织 | 研究方法、样本代表性、证据与观点的分离 |
| 时事热点 | 第一方声明、公开记录、时间线、可信报道 | 政府和机构网站、司法或立法记录、新闻机构、实时数据源 | 时间线、跨来源验证、更新状态 |
## 🗂️ 代码库结构
```
AnythingAtlas/
├── SKILL.md Core agent workflow
├── agents/openai.yaml OpenAI/Codex UI and dependency metadata
├── references/ On-demand research and output policies
├── scripts/ Markdown/HTML rendering and validation
├── assets/
│ ├── gallery/ README case cover artwork
│ ├── logo/logo.png README project logo
│ └── html-template/
│ ├── atlas.html Standalone semantic template
│ ├── atlas.css Shared foundation for all themes
│ └── themes/ Five visual themes and print styles
├── examples/
│ ├── sample-atlas.json Buildable canonical example
│ ├── anything-atlas-*.md Generated Markdown example
│ └── anything-atlas-*.html Generated standalone HTML example
├── tests/ Structural tests and qualitative cases
├── Design.md Bilingual product design
├── README.md English documentation
├── README.zh-CN.md Simplified Chinese documentation
└── LICENSE Apache-2.0
```
## 📚 文档
- [Skill 指令](SKILL.md)
- [产品设计](Design.md)
- [澄清策略](references/clarification-policy.md)
- [具体性与资源契合策略](references/specificity-and-resource-fit.md)
- [主题分类法](references/topic-taxonomy.md)
- [来源与渠道策略](references/source-and-channel-policies.md)
- [可信度标准](references/credibility-criteria.md)
- [路线图 schema](references/roadmap-schema.md)
- [输出 schema](references/output-schema.md)
- [HTML 设计指南](references/html-design-guidelines.md)
- [定性回归用例](tests/quality-cases.md)
## 🚧 状态
AnythingAtlas 是一个早期的功能性原型。核心的 skill 工作流、主题感知策略、规范内容模型、双重渲染器、五个独立的 HTML 主题、共享的打印样式以及一致性验证器均已实现。资源研究仍取决于运行该 skill 的 agent 可用的工具。
如果你对**功能改进**或更好的**用户体验**有任何想法,请提交 issue 或 PR。我们将在 24 小时内进行改进。如果你觉得 AnythingAtlas 有用,请考虑给项目点个 Star——感谢你的支持。
## ⚖️ 许可证
基于 [Apache License 2.0](LICENSE) 授权。标签:SOC Prime, 多模态安全, 学习路径规划, 开发工具, 提示词工程, 策略决策点, 逆向工具, 防御加固