ClawNetClawNet

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 结论
  • 若失败，列出阻塞项