初始化智能体：引导环境启动

初始化代理（Initializer Agent）：引导环境启动

试想一下，你雇佣了一支优秀的施工队，把他们丢到一片空地上，却没给蓝图、没清理地基，也没提供补给帐篷，就让他们“建一座摩天大楼”。这一定会陷入混乱。同样的原则也适用于 AI Agent（人工智能代理）。在真正开始编码之前，必须一丝不苟地准备好数字工作空间。在这一章中，我们将引入**初始化代理（Initializer Agent）**的概念——它是你 Harness（工程套件）中的一个专用角色，专门负责引导环境启动（Bootstrapping the environment）[1.2]。

“白板”难题

正如 Anthropic 等公司的工程团队所发现的那样，长期运行的 AI Agent 失败的主要原因之一是“白板”难题。如果你给单一的 AI 模型下达一个宏大的、高层级的提示词，比如“构建一个全栈 Web 应用程序”，它很可能会试图一次性写完所有代码。它在没有结构化计划的情况下开始工作，很快就会耗尽上下文窗口（Context window），陷入“上下文焦虑”，最终产出杂乱且未完成的代码。为了解决这个问题，Harness Engineering 采用双代理架构，将设置阶段与执行阶段分离开来。

引入初始化代理

我们不再依赖人工手动设置样板代码（Boilerplate），也不指望单一的编码 AI 完成所有工作，而是通过提示词引导专门的初始化代理来奠定基础。该代理在项目开始时仅运行一次。它的任务不是编写产品代码，而是构建后续编码会话所依赖的确定性脚手架（Scaffolding）。它充当着项目架构师和现场经理的角色。

初始化代理负责生成三个关键产物：

• 安装脚本：自动执行的脚本（如 init.sh），用于安装依赖项、连接框架并配置本地测试环境。
• 功能需求列表：将项目分解为离散且可验证任务的结构化清单。
• 版本控制与跟踪：初始化 git 仓库并创建进度日志，以跟踪已完成和未完成的工作。

构建工作空间脚手架 (init.sh)

初始化代理创建的第一个产物是安装脚本。该脚本确保任何进入仓库的后续编码代理都能立即获得一个可运行的环境。它会安装依赖项、设置自定义 Linter（代码检查工具）并配置测试框架，从而确立 Harness 的严格边界。

#!/bin/bash
# 初始化代理生成的 init.sh 示例

echo "正在引导项目环境..."

# 1. 初始化 Git
git init

# 2. 设置 Node 环境
npm init -y
npm install express typescript jest

# 3. 创建核心目录结构
mkdir -p src/routes src/tests docs

# 4. 创建初始提交以建立基准
git add .
git commit -m "chore: initial project scaffolding"

echo "环境已就绪！"

功能需求列表（JSON 为王）

接下来，初始化代理会将高层级的项目目标分解为严格的功能需求列表。近期 AI 工程研究的一个重要见解是：对于此列表而言，JSON 通常优于 Markdown。虽然 Markdown 对人类来说非常易读，但 LLM（大语言模型）在长期的自动化会话中，很容易意外更改 Markdown 格式、产生虚假的复选框或丢失嵌套列表的层级。JSON 提供了一种严谨的程序化结构，编码代理可以轻松解析、更新和验证，而不会出现格式损坏。

features.json

{
  "projectName": "TaskTracker",
  "features":[
    {
      "id": "feat_01",
      "description": "设置 Express 服务器并包含基本的健康检查端点。",
      "status": "pending",
      "testsRequired": true
    },
    {
      "id": "feat_02",
      "description": "实现用户认证中间件。",
      "status": "pending",
      "testsRequired": true
    }
  ]
}

进度日志与作为记录系统的 Git

最后，初始化代理建立了项目的“记忆”。由于 AI Agent 会在会话之间重置其上下文窗口，因此仓库本身必须成为记录系统。通过初始化 Git 并创建状态文件，初始化代理保证了当新的编码代理启动时，它可以读取 Git 提交历史和进度日志，从而瞬间理解项目的当前状态。它充当着项目的数字踪迹。

移交给编码代理

一旦初始化代理成功完成其指令序列，它的工作就结束了。它会退出，留下一个结构完美、具有确定性的环境。现在，当标准的编码代理被调用时，它面对的不再是令人不知所措的空 IDE。相反，它会读取 JSON 功能列表，挑选第一个待处理任务，编写代码，运行由安装脚本配置的本地测试，并提交代码。这种清晰的职责分离确保了你的代理能够以迭代、可预测且安全的方式工作。