Menu
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/openbkn-ai/bkn-engineering --skill bkn-envThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
| name | bkn-env |
| description | BKN 执行前环境就绪检查与 bootstrap 判定。 |
公约：../_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 插件不可用，巡检功能整体不可用，定时任务不会创建。
bkn-openbkn 检查环境）openclaw cron list 或等价命令）env_capability_matrix.patrol_cron：available | unavailableplugin_availability.test == unavailable，pipeline 阶段八整体跳过巡检在检查清单末尾，按 ../_shared/plugin-check.md 协议检测可插拔插件：
../_plugins/bkn-rules/SKILL.md 文件存在且非空 → plugin_availability.rules: available../_plugins/bkn-test/SKILL.md 文件存在且非空 → plugin_availability.test: availableplugin_mode（见 plugin-check.md）pipeline_state.yaml，pipeline 据此裁剪阶段分支在资源就绪检查阶段，获取平台可用 Vega resource 列表（仅元数据），供后续绑定阶段使用：
openbkn vega resource list 获取平台全部可用资源
--all 参数；如不支持则使用 --page-size 分页循环获取，直到获取数量等于平台返回的总数openbkn dataview list --limit 9999 作为降级方案resource_availability（仅含资源元数据，不做对象-资源匹配推荐）bkn-bindbkn-bind 按需获取（通过 openbkn vega resource query <id> -d '{"limit":1}' 推断属性）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_level | result_status | bind_mode |
|---|---|---|---|
| 数据源+资源都有 | none | ready | full |
| 仅有其一 | soft | need_user_confirm | full |
| 都没有 | none | ready | deferred |
bind_mode: deferred 表示当前环境无可用资源，pipeline 将跳过资源绑定阶段（阶段四），推送门禁中的绑定相关条件自动豁免。网络以 schema-only 模式推送，资源可后续通过 update pipeline 补绑。
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 对象匹配 Vega resource，输出绑定决议。
基于对象资源绑定结果判定关系类型，绑定 backing resource（indirect 类型）。
BKN 全生命周期编排入口。按需读取 OpenBKN SDK / CLI 操作参考。 凡涉及创建 BKN、从 PRD/文档提取对象关系、 生成或更新 `.bkn`、做数据视图绑定、环境检查、测试集生成、校验与推送时， 优先使用 bkn-creator 进行流程路由、阶段门禁、子 skill 编排与结果回执。 适用于 BKN 的 create/read/update/delete/extract/copy/validate 场景， 技能包能力补齐/skill 草案生成场景， 以及使用反馈巡检与改进场景（定时任务触发、Agent 对话质量异常、 feedback_brief 传入、知识网络持续优化）。 不应用于纯数据语义查询，该场景应交由 data-semantic 处理。