research-and-learn：AI Agent 工具实践指南
实际看research-and-learn，先要确认它的用途：Claude Code 或任何读取 AGENTS.md 的编码代理的代理工作区：它为您构建了一个离线的排名指南，指导您必须在某个日期之前理解的主题。研究与论文处理里，来源证据、引用和结论容易脱节。我会拿一篇熟悉的论文或研究问题跑完整流程，检查证据定位、引用准确性和结论可复核性。它适合需要整理研究证据并愿意复核原文的读者；采用前仍要看维护状态和试跑结果。
研究与学习
您将获得一本您必须在某个日期之前理解的主题的指南：为您编写，按重要内容排名，并且可以离线阅读。您可以使用编码代理来构建它。它会采访您，研究主题，提出适合您时间的主题排名图，然后运行子代理，一次研究、编写、检查和构建指南一个主题。当你开始阅读时，剩下的还在写。
这是一个代理工作区：您可以在其中复制和工作的文件夹，其中包含任何读取为 AGENTS.md 的编码代理。无需安装任何内容，也无需运行服务器。
它是从为一位读者在截止日期前构建的 45 个主题的指南中提取的：大约 120,000 字，在两天的代理会议中从请求到门户中的 45 个主题。该指南的内容均不在此存储库中；这里的每个文件都是针对任何主题重新编写的。
当它适合时
当满足以下三个条件时使用它：
- 你需要理解，而不是总结。你必须跟踪对话，做出决定并捍卫它们。
- 您有一个目标。 您可以在阅读后说出您必须能够做什么。
- 您有时间预算。 日期以及您每天可以阅读的时间。
它最适合一般知识满足特定情况的情况：陌生领域的新工作、接管产品或代码库、考试、搬到另一个国家。该指南教授一般主题，并将您所了解的情况及其来源分开。
你得到什么
您离线阅读的门户
您将获得一个静态 HTML 站点，该站点从磁盘打开并在网络关闭的情况下工作。
- 层次和阅读顺序。主题分为层次，例如基础知识、实践和您自己的案例。主页告诉您从哪里开始，首先是关键主题。
- 每件事都有一个等级和时间。每个主题、部分和材料都是关键的、高的、中等的或上下文，以及它的阅读时间。您可以隐藏上下文部分。
- 解释第一，深度材料。每个主题从头开始解释其主题，然后提供一些排名材料。很长的阅读清单无人阅读，人们阅读解释。
- 封闭区块中的私人事实。 来自私人来源的事实在您打开之前一直保持封闭状态，并且搜索永远不会显示它。
- 搜索各个主题和未解决的问题。它从磁盘上的文件在页面中运行。
- 词汇表，每个概念一个单词，每个单词都链接到解释它的主题。
- 每个图表的视觉索引以及它所做的工作。
- 关于您的案例的开放式问题，以及引用每个问题的主题。
- 您的笔记。 阅读标记、书签、笔记和待办事项保留在您的浏览器中。下载副本以将其移动到另一个浏览器。
- 用于共享的副本，在没有私有块的情况下构建。
- 浅色和深色主题、手机宽度和打印。
| 该首页给出阅读顺序，关键主题 first. | Search 在页面中运行并留下私有块 out. |
一张图表通过一句话的工作赢得了它的一席之地。上下文部分表明您可以跳过它。一个私人事实位于一个封闭的区块中，在此处显示为开放的。
手机宽度的深色模式：主题、有关您案例的部分和术语表。
屏幕截图显示了引擎的测试指南，这是在 engine/tests/fixture/ 中与蜜蜂一起发明的第一季。
由纯文本构建的页面
- 主题是纯文本文件： 具有短标题的 Markdown，以及用于图表和私人事实的标记块。
engine/format.md具有格式。 guide.toml保存您的设置： 标题、层、零件标题、尺码带、限制、出处标签和强调色。engine/build.py仅使用 Python 的标准库构建门户。然后它运行八项检查，如果一项失败则构建失败：- 没有从网络加载任何内容。
- 每个主题都按其等级显示在其层级中。
- 没有内部链接被破坏。
- 两个主题均已定义。
- 私人事实位于封闭的区块中，搜索无法容纳其中任何一个。
- 主页的总计与页面相符。
- 该术语表完整且没有私人来源。
- 视觉索引列出了每个图表一次。
- 守卫最后运行。 您从不发布的列表中的任何内容都不得出现在网站的任何位置。
您的代理人的工作规则
| 部分 | 它给你的代理带来了什么 |
|---|---|
技能，在.agents/skills/ |
设置采访，提出主题图的脚手架，以及删除 AI- 听起来散文的通行证 |
| 剧本 | 阶段、运行工作程序的两种方式、哪个模型执行哪个工作，以及针对预算的成本日志 |
| 内裤 | 针对每种类型的工作人员的模板，以及每种工作人员的完整示例。每个工人都以交接结束 |
| 标准 | 主题页面、来源、视觉效果、写作和门户的规则 |
| 格式检查 | 每个主题在构建之前都有其组成部分、排名和标签 |
| 棉绒 | 写作规则：禁止的词汇表、关于您的案例的未标记的声明、破折号、填充符等 |
| 守卫 | 您的从不发布列表无法通过 lint 和构建。在共享之前，私人术语扫描会检查副本 |
指南是如何构建的
| 阶段 | 会发生什么 | 你做什么 |
|---|---|---|
| 设置 | 代理人采访您：读者、目标、日期和时间、主题、您的情况、您的消息来源 | 回答，并将您的源放入 context/sources/ |
| 脚手架 | 客服人员会研究您的情况并提出适合您工作时间的主题图 | 什么都没有 |
| 开球 | 代理显示其假设和地图 | 确认或更改它们 |
| 飞行员 | 每层一个主题，已编写、检查和构建 | 阅读它们。说说要改变什么 |
| 波浪 | 首先是关键主题，然后是高主题，然后是中主题。每次完成时门户都会重建 | 开始阅读。当你有足够的时候停止构建 |
| 整合 | 层级地图、主页、术语表、开放式问题、指南检查 | 什么都没有 |
| 阅读 | 您阅读、标记并做笔记。修复分批发布 | 阅读 |
你需要经历三次：准备面试、启动和试播。试播集先于扇出，因为只有当您看到页面时，您对深度、长度和视觉效果的品味才会显现出来。在源代码版本中，所有三位试点作者都将其尺寸范围填满到天花板，读者在阅读后将尺寸范围剪掉。
费用是多少
主要是代币。在源版本中，一个主题通过批量事实检查到达门户大约需要 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。
里面有什么
| 路径 | 它包含什么 |
|---|---|
AGENTS.md |
在文件夹中工作的任何代理的操作指南 |
guide.toml |
您的指南的设置：标题、层级、部分标题、大小、限制、标签、强调色 |
docs/ |
一页上的方法、标准、您的要求和决策日志 |
context/ |
关于您、您的目标和您的情况以及您的冻结来源的了解 |
curriculum/topic-map.md |
建造了什么以及为什么 |
orchestration/ |
协调者的剧本、工作人员简报、董事会和交接 |
content/ |
主题（按级别） |
engine/ |
构建、八项检查、格式检查、样式和脚本 |
tools/ |
lint 和私有术语扫描 |
.agents/skills/ |
设置、脚手架和删除 AI- 听起来散文的通行证。 .claude/skills 链接在此 |
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 描述了其格式。
