Witt-AgentOS 搭建器

从零搭建 AgentOS 工作区的具体痛点

手动配置 AgentOS 运行环境时，开发者常陷入重复劳动：要逐一创建目录结构、编写 workspace.yaml 配置文件、核对环境变量兼容性，稍有疏漏就会导致 Agent 启动失败。尤其当项目需要多环境（开发/测试/生产）切换时，手动维护配置的差异更容易引发线上故障，且缺乏统一的状态校验机制，排查问题往往要从头梳理配置链路。

技能的核心能力与关键步骤

这个技能围绕「标准化搭建」设计，核心能力包括：

• 自动生成符合 AgentOS 规范的目录结构，避免手动创建时的遗漏
• 根据需求快速生成 workspace.yaml 配置文件，内置常用参数模板
• 校验环境依赖完整性，提前发现版本不兼容问题

使用时的关键步骤很清晰：先明确工作区用途（如数据清洗、任务调度），技能会先扫描当前环境，判断是否存在残留配置文件；接着按 AgentOS 规范初始化目录结构，生成默认配置文件；最后输出初始化报告，标注待补充的自定义参数，整个过程约 1-2 分钟。

适用边界与注意事项

该技能仅支持 AgentOS 1.2.0 及以上版本，低版本环境需先手动升级依赖。另外，虽然能生成基础配置，但涉及业务逻辑的自定义脚本（如 hooks/ 目录下的回调函数）仍需开发者自行编写，技能不会干预业务代码部分。建议在独立虚拟环境中使用，避免与现有项目的配置产生冲突。