使用指南

1. Bootstrap 新项目

最小项目

scripts/bootstrap_new_project.sh /path/to/my-agent-project

带常用可选模块

scripts/bootstrap_new_project.sh /path/to/my-agent-project \
  --with-eval-harness \
  --with-multi-run \
  --with-tmux

全部可用模块

scripts/bootstrap_new_project.sh /path/to/my-agent-project \
  --with-eval-harness \
  --with-multi-run \
  --with-tmux \
  --with-browser-adapter \
  --with-docs-dual-format

2. 更新已有项目

向之前 bootstrap 的项目或任意仓库添加新模块：

Bootstrap 项目

scripts/update_existing_project.sh /path/to/existing-project --with-docs-dual-format

模块文件合并到项目根目录，BOOTSTRAP_ADOPTION.md 自动更新。

非 Bootstrap 项目

scripts/update_existing_project.sh /path/to/any-repo --with-docs-dual-format

模块文件隔离在 .bootstrap/modules/<name>/ 下，不影响现有目录结构。脚本会打印集成提示。

脚本行为

3. 验证完整性

scripts/validate_template_integrity.sh

检查所有文档化的 Core 和 Module 模板表面在更改后仍然存在。

4. 检查清单

新项目检查清单

• 确认 docs/BOOTSTRAP_ADOPTION.md 存在并命名已采纳的 core
• 确认 docs/OPERATIONS.md 存在并告知运维人员首先查看哪里
• 确认 artifacts/runs/ 存在作为运行时工作空间根目录
• 确认运行时输出不会落地到版本化源目录
• 确认日志和状态文件位置已文档化
• 确认 .gitignore 排除运行时制品和本地状态
• 确认 bootstrap 源版本已记录
• 确认是否需要高级评估隔离
• 确认是否应采纳上下文、工具或交付模块

模块选择检查清单

• 项目是否需要专用评估目录和可重复回归路径？
• 项目是否比较多次运行或维护命名运行组？
• 项目是否需要分离式长时间终端观察（如 tmux）？
• 项目是否需要比 Core 基线更严格的隔离或编排？
• 项目是否集成浏览器支持工具或浏览器自动化？
• 项目是否需要双格式文档（CLI md + 浏览器 HTML）？

5. 查看文档

启动文档服务

cd agent-bootstrap
python3 -m http.server 8080 -d docs/html/

SSH 隧道（远程服务器）

# 在本地机器执行：
ssh -L 8080:127.0.0.1:8080 -N user@<服务器地址>

# 浏览器打开 http://localhost:8080