> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.agentspro.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 启动引导

> Zeus Agent 启动引导 — 每次运行前的工作空间与上下文准备

Bootstrapping 是每次 Agent 运行前的**准备仪式**：组装 System Prompt、加载工具、注入用户画像与记忆，确保 Agent 以正确的身份、能力和上下文开始工作。

***

## What Bootstrapping Does

每次 Agent 调用时，Zeus 执行以下引导流程：

```mermaid theme={null}
flowchart TD
    start["Agent 调用开始"]

    subgraph Bootstrap["Bootstrapping"]
        direction TB
        prompt["组装 System Prompt<br/>CORE + SOUL + TOOLS + WORKFLOW + MEMORY"]
        mode["注入模式提示词<br/>Agent / Ask / Plan"]
        dynamic["动态注入上下文<br/>时间、Profile、Memory、Skills..."]
        tools["加载工具集<br/>Built-in + MCP + OAuth + Connector"]
    end

    ready["Agent 就绪，开始执行"]

    start --> Bootstrap --> ready
```

1. **组装 System Prompt** — 从多个 Bootstrap 文件按顺序拼接核心提示词
2. **选择模式提示词** — 根据当前模式（Agent / Ask / Plan）注入对应行为规范
3. **动态注入上下文** — 注入当前时间、用户/项目画像、相关记忆、Skills 元数据等
4. **加载工具集** — 按模式过滤，装配可用工具

***

## Bootstrap Files

Zeus 的 System Prompt 采用分层架构，由多个 Markdown 文件组合而成。每个文件承担独立职责，启动时按顺序拼接注入。

```mermaid theme={null}
graph LR
    subgraph CorePrompts["核心提示词（静态）"]
        direction TB
        CORE["CORE.md<br/>核心能力与限制"]
        SOUL["SOUL.md<br/>人格、边界、语气"]
        TOOLS["TOOLS.md<br/>工具层级与使用指南"]
        WORKFLOW["WORKFLOW.md<br/>任务处理方法论"]
        MEMORY["MEMORY.md<br/>记忆工具指令"]
    end

    subgraph Dynamic["动态注入（每次运行）"]
        direction TB
        time["当前时间信息"]
        connector["Connector Skills<br/>Browser / Desktop"]
        mode["模式提示词<br/>agent / ask / plan"]
        skills["Skills 元数据<br/>渐进式披露"]
        mcp["MCP 提示词模板"]
        resources["资源文件"]
        profile["用户/项目画像"]
        memories["相关记忆"]
        sandbox["沙盒文件"]
        attachments["聊天附件"]
    end

    CorePrompts --> Dynamic
```

### 核心文件

| 文件            | 职责        | 内容概要                          |
| ------------- | --------- | ----------------------------- |
| `CORE.md`     | 核心身份与能力声明 | 编程语言、信息处理、内容创作、文件处理、限制        |
| `SOUL.md`     | 人格与价值观    | 专业文本风格（不使用 emoji）、准确性、隐私、安全原则 |
| `TOOLS.md`    | 工具使用指南    | 五层工具体系的描述与选择规则，动态替换当前可用工具列表   |
| `WORKFLOW.md` | 任务处理流程    | 快速响应 vs 复杂任务、任务规划规则、完成标准      |
| `MEMORY.md`   | 记忆系统指令    | 触发词、工具用法、类型选择、作用域、优先级规则       |

<Card title="System Prompt 完整说明" icon="file-lines" href="/en/ai-backend/fundamentals/System-Prompt">
  查看每个 Bootstrap 文件的详细内容和设计原则
</Card>

***

## Mode Prompts

根据当前交互模式，注入不同的行为提示词：

| 文件              | 模式    | 行为                    |
| --------------- | ----- | --------------------- |
| `agent_mode.md` | Agent | 完整工具访问，主动执行与修改        |
| `ask_mode.md`   | Ask   | 只读工具，分析与问答，引导切换模式     |
| `plan_mode.md`  | Plan  | 只读（不执行），研究与规划，输出结构化方案 |

模式在 `invoke()` 入口处立即生效。Ask 模式下写操作工具被替换为占位符（渐进式披露），Agent 知道工具存在但无法调用，会引导用户切换模式。

***

## Dynamic Injection

每次运行时，以下上下文被动态注入到 System Prompt：

| 注入项              | 说明                     | 来源             |
| ---------------- | ---------------------- | -------------- |
| 当前时间             | 让 Agent 感知时间           | 系统时钟           |
| 用户画像             | 用户偏好、技能、习惯的摘要          | Memory Profile |
| 项目画像             | 当前项目的技术栈、约束            | Memory Profile |
| 相关记忆             | 与当前对话相关的历史记忆           | Memory Search  |
| Skills 元数据       | 可用技能的名称和描述（不含完整内容）     | SkillsManager  |
| Connector Skills | Browser / Desktop 操控指令 | 按连接状态注入        |
| MCP 提示词          | 用户选择的 MCP Prompt 模板    | MCP 服务器        |
| 资源文件             | 用户通过 @ 引用的上下文文件        | 前端请求           |
| 沙盒文件             | 沙盒中已有的文件列表             | Sandbox 状态     |
| 聊天附件             | 用户上传的图片、文档             | 前端请求           |

### Skills 渐进式披露

Skills 采用两阶段加载策略，降低初始 token 消耗：

| 阶段             | 内容             | Token 消耗 |
| -------------- | -------------- | -------- |
| Discovery（启动时） | 技能名称 + 一行描述    | 极低       |
| Activation（按需） | 完整 SKILL.md 内容 | 按需       |
| Execution（按需）  | 脚本文件 + 参考资料    | 按需       |

启动时仅注入元数据列表，Agent 通过 `skill_activate` 工具按需加载完整内容。

<CardGroup cols={2}>
  <Card title="Skills" icon="wand-magic-sparkles" href="/en/ai-backend/fundamentals/Skills">
    Skills 定义、管理 API 和内置技能说明
  </Card>

  <Card title="Context" icon="brain" href="/en/ai-backend/fundamentals/Context">
    上下文组装的完整流程和 Token 优化策略
  </Card>

  <Card title="Memory" icon="database" href="/en/ai-backend/fundamentals/Memory">
    四层记忆模型、用户画像与项目画像
  </Card>

  <Card title="Tools" icon="wrench" href="/en/ai-backend/fundamentals/Tools">
    四层工具体系和模式过滤规则
  </Card>
</CardGroup>

***

## Related Docs

* **Agent Loop** — Bootstrapping 完成后进入执行循环：[Agent Loop](/en/ai-backend/fundamentals/agent-loop)
* **Workspace** — 工作空间初始化和文件存储：[Agent Runtime](/en/ai-backend/fundamentals/agent-runtime)