Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/openbkn-ai/bkn-engineering --skill bkn-env명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
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 处理。