Project Provisioning Setup

这个 skill 是 project-provisioning 的前置 setup / bootstrap 层。

推荐顺序：先安装并运行 project-provisioning-setup；当 readiness 通过后，再进入 project-provisioning。

它不负责真正创建新项目，而是先把目标环境检查清楚、初始化好，再明确告诉使用者：当前这台 OpenClaw 实例是否已经具备“项目开通”条件。

何时使用

在以下情况下使用：

• 第一次在某台 OpenClaw 实例上安装或复用 project-provisioning
• 不确定目标环境是否已具备 dispatch / orchestration 前提
• 需要检查 openclaw、jq、python3、git 等依赖是否齐全
• 需要确认 dispatch agent 是否存在、工作区是否存在、allowAgents 结构是否可写
• 需要初始化 state/projects.json 或生成本地运行配置
• 需要做首次 smoke test 之前的环境准备

不要在以下情况下使用：

• 目标环境已经准备完成，只是想正式开通一个新项目
• 当前任务是项目功能开发、缺陷修复、测试或部署
• 只是想查询某个项目是否已存在于 registry

输出目标

执行这个 skill 后，应该至少给出这 4 类结果：

• environment_status
• dispatch_status
• config_status
• ready_for_project_provisioning: yes/no

如果还没准备好，必须明确列出阻塞项，而不是模糊地说“可能需要检查”。

标准工作流

1. 检查目标 skill 目录是否存在：project-provisioning
2. 检查基础依赖：
   • openclaw
   • bash
   • python3
   • jq
   • git（若目标环境需要 clone repo）
3. 检查 OpenClaw 主配置和 dispatch agent：
   • ~/.openclaw/openclaw.json 是否存在
   • DISPATCH_AGENT_ID 是否存在于 agents.list
   • dispatch workspace 是否存在
   • subagents.allowAgents 是否存在或可初始化
4. 检查 project-provisioning 所需目录与关键文件：
   • SKILL.md
   • config.env.example
   • scripts/
   • references/
   • assets/project-dev-template/
5. 生成本地运行配置：
   • 优先写 state/config.local.env
   • 不要要求用户直接改发布态文件
6. 调用 project-provisioning/scripts/init.sh 初始化 registry
7. 输出 readiness 结论
8. 如用户明确要求，可继续引导执行一次最小 smoke test

配置策略

默认建议使用本地运行态配置，而不是直接修改发布态文件：

• 本地运行配置：project-provisioning/state/config.local.env
• 发布模板：project-provisioning/config.env.example

最少应确认这些变量：

• DISPATCH_AGENT_ID
• PROJECTS_ROOT
• PROJECT_ID_PREFIX

可选再确认：

• ESCALATION_AGENT_ID
• PROJECT_AGENT_SUFFIX
• PROJECT_AGENT_MODEL

安全与边界

• 默认只做检查、初始化、生成本地配置
• 不要在未确认前直接创建真实业务项目
• 不要自动替用户创建 dispatch agent 本身
• 不要隐式覆盖已有 config.local.env
• 如果发现已有本地配置，应先报告并读取现状，而不是直接重写
• 如果关键前提缺失，应返回明确阻塞项并停止，而不是进入 provisioning 阶段

关键文件

按需读取这些资源：

• references/checklist.md
• references/quickstart.md
• scripts/check_env.sh
• scripts/check_dispatch.sh
• scripts/check_target_skill.sh
• scripts/check_paths.sh
• scripts/bootstrap_local_config.sh
• scripts/run_setup.sh
• scripts/emit_readiness_report.py

与主 skill 的衔接

推荐安装顺序：

1. project-provisioning-setup
2. project-provisioning

推荐使用顺序：

1. 先运行 project-provisioning-setup
2. 当 readiness 为 yes 时，再进入 project-provisioning

推荐话术：

• 环境已具备项目开通条件，可继续使用 project-provisioning 创建新的 per-project dev agent

当 readiness 为 no 时，必须输出：

• 失败检查项
• 缺失依赖
• 缺失目录或配置
• 建议修复步骤

返回结果

至少返回：

• 目标 project-provisioning skill 路径
• dispatch agent 检查结果
• 依赖命令检查结果
• 本地配置路径
• registry 路径
• readiness 结论
• 若失败，列出阻塞项