# Bkn Env

> BKN 执行前环境就绪检查与 bootstrap 判定。

- Skill: `openbkn-ai/bkn-env` (Agent Skill)
- Install (CLI): `npx skillmds@latest add openbkn-ai/bkn-env`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openbkn-ai/bkn-env/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: openbkn-ai (https://skillmd.com/u/openbkn-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/openbkn-ai/bkn-env

---


# 环境检查

公约：`../_shared/contract.md`
插件检测：`../_shared/plugin-check.md`

## 做什么

在绑定/推送前，检查环境是否就绪。如果缺少必要资源，判定是否需要搭建。同时检测可插拔插件可用性。

## 输入

- `network_dir`：网络目录（`.bkn` 文件位于 `{network_dir}/bkn/`）
- `network_context`：网络名称、领域
- `goal`：validate / push / update / copy

## 检查清单

| 检查项 | 方法 | 失败结果 |
|--------|------|---------|
| 草案目录 | `{network_dir}/bkn/` 存在 + `network.bkn` 齐备 | blocked |
| CLI | `openbkn --version` | blocked |
| 平台连通性 | `openbkn config show` | blocked |
| 业务域 | 配置是否匹配 | warning |
| 同名网络 | `openbkn bkn list` | 记录冲突 |
| 资源就绪 | Vega resource 是否存在 | 触发 bind_mode 判定 |
| Skill 模块 | `openbkn skill list --limit 1` | warning（记入 capability_matrix） |
| Agent 工厂 | `openbkn agent list --limit 1` | warning（记入 capability_matrix） |
| 定时任务（巡检用） | OpenClaw 调度 API 可用性 | warning（记入 capability_matrix） |

所有 CLI 操作委托 `bkn-openbkn`（读取 `../bkn-openbkn/SKILL.md`）。

### 定时任务能力检测

在检查清单末尾，检测 OpenClaw 定时任务能力：

**前提条件**：定时任务能力仅在 `plugin_availability.test == available`（有 `bkn-test` 插件）时才有意义。若 test 插件不可用，巡检功能整体不可用，定时任务不会创建。

1. 检测 OpenClaw 是否已安装且可访问（委托 `bkn-openbkn` 检查环境）
2. 检测 OpenClaw 调度 API 是否可用（`openclaw cron list` 或等价命令）
3. 结果写入 `env_capability_matrix.patrol_cron`：`available` | `unavailable`
4. 不可用时不阻塞流程，但若同时 `plugin_availability.test == unavailable`，pipeline 阶段八整体跳过巡检

### 插件可用性检测

在检查清单末尾，按 `../_shared/plugin-check.md` 协议检测可插拔插件：

1. 检测 `../_plugins/bkn-rules/SKILL.md` 文件存在且非空 → `plugin_availability.rules: available`
2. 检测 `../_plugins/bkn-test/SKILL.md` 文件存在且非空 → `plugin_availability.test: available`
3. 根据检测结果判定 `plugin_mode`（见 `plugin-check.md`）
4. 结果写入 `pipeline_state.yaml`，pipeline 据此裁剪阶段分支

## Resource 可用性检查

在资源就绪检查阶段，获取平台可用 Vega resource 列表（仅元数据），供后续绑定阶段使用：

1. 执行 `openbkn vega resource list` 获取平台全部可用资源
   - **必须获取全部视图**：优先使用 `--all` 参数；如不支持则使用 `--page-size` 分页循环获取，直到获取数量等于平台返回的总数
   - 如平台未返回总数且 CLI 不支持分页参数，执行 `openbkn dataview list --limit 9999` 作为降级方案
2. 输出 `resource_availability`（仅含资源元数据，不做对象-资源匹配推荐）
3. 对象-资源匹配的决策权交由 `bkn-bind`
4. **资源 property schema 由 `bkn-bind` 按需获取**（通过 `openbkn vega resource query <id> -d '{"limit":1}'` 推断属性）

```yaml
resource_availability:
  total_resources: 0
  fetched_resources: 0    # 实际获取的资源数量
  truncated: false        # true 表示平台有截断风险，bkn-bind 应 warn 用户
  available_resources: [{resource_id, resource_name, datasource_id, property_count}]
```

## Bootstrap 与 bind_mode 判定

| 资源状态 | bootstrap_level | result_status | bind_mode |
|---------|----------------|---------------|-----------|
| 数据源+资源都有 | none | ready | full |
| 仅有其一 | soft | need_user_confirm | full |
| 都没有 | none | ready | deferred |

`bind_mode: deferred` 表示当前环境无可用资源，pipeline 将跳过资源绑定阶段（阶段四），推送门禁中的绑定相关条件自动豁免。网络以 schema-only 模式推送，资源可后续通过 update pipeline 补绑。

## 输出

```yaml
environment_status: ready | blocked | warning
bootstrap_required: true | false
bootstrap_level: soft | none
bind_mode: full | deferred
plugin_mode: full | limited
plugin_availability:
  rules: available | unavailable
  test: available | unavailable
check_summary: {cli, connectivity, domain, draft, resource_readiness}
blocking_issues: [{issue, reason, suggested_fix}]
bootstrap_plan: {steps, estimated_effort}
resource_availability: {total_resources, fetched_resources, truncated, available_resources}
env_capability_matrix:
  cli: available | unavailable
  platform: available | unavailable
  skill_module: available | unavailable
  agent_factory: available | unavailable
  resource: available | unavailable
  context_loader: available | unavailable
  patrol_cron: available | unavailable  # P1-5/P1-6 巡检自动创建
```

`env_capability_matrix` 和 `plugin_availability` 写入 `pipeline_state.yaml`，后续阶段据此裁剪分支（如 Skill 注册降级、Agent QA 降级、插件阶段跳过）。

## 约束

- 仅检查不修改 .bkn
- 不执行 push/delete/update
- bootstrap 前需用户确认