> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 文章指南

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">需要帮助？</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>在 Discord 提问</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>提交 GitHub Issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/zh-Hans/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>支持指南</span>
    </a>
  </div>
</div>

Lab article 是长期有效的手册页面。它把一个有价值的 signal、问题或研究线索，转化成未来学习者可以直接使用的结构化解释，而不需要他们回到最初的聊天或讨论现场。

当输出应该成为关于概念、模式、系统、生态方向或案例研究的长期页面时，使用这个贡献类型。Lab article 不是聊天记录、快速笔记，也不是松散的 source roundup。它应该帮助读者理解主题、为什么重要、如何思考，以及下一步读什么。

## 文章应放置在哪里

| Lane            | 内容范围                              | 示例主题                                                                 |
| --------------- | --------------------------------- | -------------------------------------------------------------------- |
| `foundations/`  | 核心概念和第一性原理解释。                     | 什么是 agent、agent systems、agents vs. workflows                         |
| `patterns/`     | 会在多种 agent systems 中反复出现的设计模式。    | memory and retrieval、planning and reflection、runtime building blocks |
| `systems/`      | 系统级架构、基础设施、协议和 evaluation。        | context engineering、interoperability、observability                   |
| `ecosystem/`    | 工具、框架、平台，以及 agent builder 周边生态。   | agent frameworks、low-code builders、platform comparisons              |
| `case-studies/` | 解释 agent systems 如何在真实场景中工作的应用案例。 | deep research agents、customer support agents                         |

根据主题选择分类，而不是根据启发草稿的源章节来选。

## Issue 和 review 流程

在起草文章之前，先创建 GitHub issue。使用 `Content Proposal` 表单，并选择 `Lab article` 或 `Major revision to an existing lab page`。

核心团队会先 review issue。他们可能批准 scope、请求修改，或拒绝 proposal。issue 被批准或确认之后，贡献者可以 fork 仓库并开始修改。

核心团队会再单独 review pull request。他们可能批准、请求修改，或拒绝 PR。如果 issue 或 PR 被拒绝，贡献者仍然可以保留自己的 fork，并在仓库外继续使用这些改动。

## 必需结构

每篇文章都应遵循：

* [metadata-schema.mdx](/zh-Hans/publications/metadata-schema) 中的元数据契约
* [Article Template](/zh-Hans/contributor-kit/templates/article-template) 中的结构

必需部分：

* `Summary`
* `Why It Matters`
* `Mental Model`
* `Architecture Diagram`
* `Tool Landscape`
* `Tradeoffs`
* `Citations`
* `Reading Extensions`
* `Update Log`

## 工作规则

* 使用仓库原生英文撰写。
* 概念和引用使用来源输入，而不是直接保留其行文。
* 保持图示简洁，并由仓库自有内容维护。
* 链接到相关的实验室页面，使文章成为更大地图的一部分。
* 保持页面具有长期适用性。如果某个说法很可能很快过时，要么验证它，要么
  用不依赖时间的语言来写。

## 完成标准

当一篇文章满足以下条件时，即可进入审阅：

* 与该分类清晰匹配
* 遵循元数据和章节模板
* 引用了主要来源
* 避免照搬上游教学流程
* 至少包含一个有用的内部阅读链接