Agent Project Bootstrap

为新 Agent 项目提供可用的工程基线
不再每次从零发明仓库结构、运行时布局和运维文档

Core Templates 4 Modules Bootstrap Script Update Script Validation docs-dual-format

Bootstrap Layers

Core5 rules 基线模板 — 每个项目都需要
Modules4 modules 可选能力 — 按需启用
Reference理念与迁移材料 — 不复制到项目

快速操作

新建项目scripts/bootstrap_new_project.sh
更新项目scripts/update_existing_project.sh
验证完整性scripts/validate_template_integrity.sh

一句话总结

Agent Project Bootstrap 帮助团队快速启动新 Agent 项目并保持结构一致性。它让运行时状态、可观测性、状态持久化、评估隔离和仓库卫生从第一天起就可预测。

通过 scaffold + selective modules + reference docs 模式，只复制项目真正需要拥有的文件，其余保持为引用。

目标项目类型

此 bootstrap 针对具有以下一个或多个特征的项目：

非目标

此仓库不是业务域启动套件，不提供产品逻辑、应用框架或技术栈特定的功能代码。它提供工程结构，而非产品行为。

典型采纳流程

  1. 阅读 采纳模型 和 Core 规则
  2. 用 scripts/bootstrap_new_project.sh 生成新项目
  3. 决定是否需要可选 Modules
  4. 在新项目中记录采纳内容到 docs/BOOTSTRAP_ADOPTION.md
  5. 让新项目拥有其复制的模板并本地演进
  6. 当 bootstrap 源发生变化时验证模板完整性

仓库地图

路径用途
templates/core/每个新项目复制的基线文件
templates/modules/可选附加模块（tmux, eval-harness, multi-run, browser-adapter, docs-dual-format）
scripts/bootstrap_new_project.sh从模板创建新项目
scripts/update_existing_project.sh向已有项目添加新模块
scripts/validate_template_integrity.sh检查模板表面完整性
docs/参考材料和采用指南（此 HTML 文档 + Markdown 源文件）
checklists/新项目与模块选择检查清单