实际看research-and-learn，先要确认它的用途：Claude Code 或任何读取 AGENTS.md 的编码代理的代理工作区：它为您构建了一个离线的排名指南，指导您必须在某个日期之前理解的主题。研究与论文处理里，来源证据、引用和结论容易脱节。我会拿一篇熟悉的论文或研究问题跑完整流程，检查证据定位、引用准确性和结论可复核性。它适合需要整理研究证据并愿意复核原文的读者；采用前仍要看维护状态和试跑结果。

研究与学习

您将获得一本您必须在某个日期之前理解的主题的指南：为您编写，按重要内容排名，并且可以离线阅读。您可以使用编码代理来构建它。它会采访您，研究主题，提出适合您时间的主题排名图，然后运行子代理，一次研究、编写、检查和构建指南一个主题。当你开始阅读时，剩下的还在写。

这是一个代理工作区：您可以在其中复制和工作的文件夹，其中包含任何读取为 AGENTS.md 的编码代理。无需安装任何内容，也无需运行服务器。

它是从为一位读者在截止日期前构建的 45 个主题的指南中提取的：大约 120,000 字，在两天的代理会议中从请求到门户中的 45 个主题。该指南的内容均不在此存储库中；这里的每个文件都是针对任何主题重新编写的。

当它适合时

当满足以下三个条件时使用它：

• 你需要理解，而不是总结。你必须跟踪对话，做出决定并捍卫它们。
• 您有一个目标。 您可以在阅读后说出您必须能够做什么。
• 您有时间预算。 日期以及您每天可以阅读的时间。

它最适合一般知识满足特定情况的情况：陌生领域的新工作、接管产品或代码库、考试、搬到另一个国家。该指南教授一般主题，并将您所了解的情况及其来源分开。

你得到什么

您离线阅读的门户

您将获得一个静态 HTML 站点，该站点从磁盘打开并在网络关闭的情况下工作。

• 层次和阅读顺序。主题分为层次，例如基础知识、实践和您自己的案例。主页告诉您从哪里开始，首先是关键主题。
• 每件事都有一个等级和时间。每个主题、部分和材料都是关键的、高的、中等的或上下文，以及它的阅读时间。您可以隐藏上下文部分。
• 解释第一，深度材料。每个主题从头开始解释其主题，然后提供一些排名材料。很长的阅读清单无人阅读，人们阅读解释。
• 封闭区块中的私人事实。 来自私人来源的事实在您打开之前一直保持封闭状态，并且搜索永远不会显示它。
• 搜索各个主题和未解决的问题。它从磁盘上的文件在页面中运行。
• 词汇表，每个概念一个单词，每个单词都链接到解释它的主题。
• 每个图表的视觉索引以及它所做的工作。
• 关于您的案例的开放式问题，以及引用每个问题的主题。
• 您的笔记。 阅读标记、书签、笔记和待办事项保留在您的浏览器中。下载副本以将其移动到另一个浏览器。
• 用于共享的副本，在没有私有块的情况下构建。
• 浅色和深色主题、手机宽度和打印。

一张图表通过一句话的工作赢得了它的一席之地。上下文部分表明您可以跳过它。一个私人事实位于一个封闭的区块中，在此处显示为开放的。

手机宽度的深色模式：主题、有关您案例的部分和术语表。

屏幕截图显示了引擎的测试指南，这是在 engine/tests/fixture/ 中与蜜蜂一起发明的第一季。

由纯文本构建的页面

• 主题是纯文本文件： 具有短标题的 Markdown，以及用于图表和私人事实的标记块。 engine/format.md 具有格式。
• guide.toml 保存您的设置： 标题、层、零件标题、尺码带、限制、出处标签和强调色。
• engine/build.py 仅使用 Python 的标准库构建门户。然后它运行八项检查，如果一项失败则构建失败：
  1. 没有从网络加载任何内容。
  2. 每个主题都按其等级显示在其层级中。
  3. 没有内部链接被破坏。
  4. 两个主题均已定义。
  5. 私人事实位于封闭的区块中，搜索无法容纳其中任何一个。
  6. 主页的总计与页面相符。
  7. 该术语表完整且没有私人来源。
  8. 视觉索引列出了每个图表一次。
• 守卫最后运行。 您从不发布的列表中的任何内容都不得出现在网站的任何位置。

您的代理人的工作规则

指南是如何构建的

你需要经历三次：准备面试、启动和试播。试播集先于扇出，因为只有当您看到页面时，您对深度、长度和视觉效果的品味才会显现出来。在源代码版本中，所有三位试点作者都将其尺寸范围填满到天花板，读者在阅读后将尺寸范围剪掉。

费用是多少

主要是代币。在源版本中，一个主题通过批量事实检查到达门户大约需要 320,000 到 400,000 个代币，而通过独立审查则需要大约 480,000 到 650,000 个代币。按照这个速度，在搭建和集成之前，一本包含 15 个主题的指南大约需要 5 到 600 万代币。协调器根据其预测记录每次运行的成本，因此计划会在预算用完之前发生变化。

开始

您需要一个能够读取 AGENTS.md、运行命令并访问网络的编码代理，以及 Python 3.11 或更高版本。没有安装其他任何东西。该工作区是使用 克劳德代码 构建和测试的。

git clone https://github.com/batirko/research-and-learn.git my-guide

打开代理中的文件夹并说出您需要学习的内容以及学习时间。设置技能就从那里开始。

这些技能位于 .agents/skills/ 中，大多数代理都会在其中查看，并且 .claude/skills 链接到那里的克劳德代码。在 Windows 上，除非符号链接打开，否则 git 将链接检查为普通文件。要在那里使用 Claude 代码，请将 .agents/skills 复制到 .claude/skills。

要随时构建门户，请从文件夹运行此命令，然后打开 site/index.html：

python3 engine/build.py

如果您的 python3 版本早于 3.11，请改为调用 python3.11。

里面有什么

context/、curriculum/、content/ 和 orchestration/ 下的所有内容均以带有说明的模板开始。设置和脚手架填充它们，你的副本就成为你的项目。要升级，请从较新版本复制 engine/ 和 tools/：您编写的任何内容都不会存在其中。如果门户工作人员更改了指南的引擎，决策日志会说明内容，因此可以在升级后再次进行更改。

即使您以另一种方式构建指南，也值得采取的部分

解释承载知识。材料是为了深度，清单太长是选择的失败。每个主题和每个指南的关键材料都有上限，并且每个材料都说了它提供了指南无法提供的内容。

对所有内容进行排名。 主题、部分和材料共享同一个四级等级。了解某个部分的上下文的读者可以毫无愧疚地跳过它。

证据和解释是分开的。 关于您的情况的每一个事实都带有一个标签，说明它的来源。一个未知的问题变成了一个悬而未决的问题，并有可能的答案，而不是把猜测写成事实。

视觉效果赢得一席之地。它需要在绘画之前写下一句话，以及一个有形状的主题。大多数主题都没有。

每个概念一个词和一个家。 词汇表禁止使用同义词，主题图命名了解释每个共享想法的一个主题。

扇出之前的试播集。 三个主题，由您阅读，然后再写四十个主题，长度错误。

共享门户之前

一个内置的门户保存着每个私人区块的文本，关闭但存在。要将其发送给任何人，请在没有他们的情况下构建一个副本，然后根据不得离开您的计算机的名称和短语列表扫描该副本：

python3 engine/build.py --share

python3 tools/scan.py files site-share/ --terms ~/path/to/your-private-terms.txt

该列表位于文件夹之外，因此列表本身永远不会被共享。 engine/core/terms.py 描述了其格式。