Bkn Distribute

多平台分发

公约：../../_shared/contract.md

做什么

将 bkn-rules 生成的业务规则 Skill 文件，安装到用户选择的一个或多个 AI 平台本地目录中，使各平台的 Agent 能加载并使用这些规则。

输入

• skill_artifact_path：bkn-rules 输出的 Skill 文件路径列表
• network_id：网络唯一标识
• network_name：网络名称
• skill_version（可选）：Skill 版本号，来自 bkn-rules 输出

已知平台

安装目录标识为工作区根目录下的平台根文件夹（如 .cursor、.claude、.openclaw）。若某平台根目录不存在，仍可询问用户是否创建。 OpenClaw 的 skills 子目录位于 .openclaw/workspace/ 下，而非 .openclaw/ 根目录。

平台目录结构

各平台统一使用 skills/{network_id}-rules/ 子目录，与 .cursor/skills/ 结构一致：

{platform_root}/
└── skills/
    └── {network_id}-rules/
        └── {skill_name}.md   # SKILL.md 格式

流程

1. 检测已存在的平台

扫描工作区根目录，识别已知平台目录标识是否存在：

• .cursor/ → Cursor
• .claude/ → Claude
• .openclaw/workspace/ → OpenClaw

输出 detected_platforms 列表（包含平台名、路径、是否已存在）。

2. 呈现平台选择菜单

向用户展示以下信息：

业务规则 Skill 已生成，请选择安装到哪些 AI 平台：

已检测到平台：
  [x] Cursor (.cursor/skills/)     ← 已存在
  [ ] Claude (.claude/skills/)     ← 未检测到

其他已知平台：
  [ ] OpenClaw (.openclaw/workspace/skills/)

请输入选项（多选，用逗号分隔，如 A,C），或输入 N 跳过：
  A. Cursor
  B. Claude（将创建 .claude/skills/ 目录）
  C. OpenClaw（将创建 .openclaw/workspace/skills/ 目录）
  N. 跳过，不安装到任何本地平台

• 已存在的平台默认选中（用户可取消）
• 未检测到的平台不默认选中，选择后需确认将创建目录
• 用户可手动输入平台路径（如 windsurf/.windsurf/skills/）

3. 执行分发

对每个选中的平台：

1. 若平台目录不存在，创建目录结构
   • OpenClaw 特殊路径：.openclaw/workspace/skills/{network_id}-rules/
   • 其他平台：{platform_root}/skills/{network_id}-rules/
2. 将 skill_artifact_path 中的每个 Skill 文件复制到目标路径
   • 若目标文件已存在，覆盖更新
3. 保持源文件名不变

4. 回读校验

对每个平台：

• 确认目标目录下每个 Skill 文件存在且内容非空
• 记录 files_copied 列表和 status

5. 输出分发结果

distribution_result:
  platforms:
    - platform: cursor
      platform_root: ".cursor"
      target_path: ".cursor/skills/{network_id}-rules/"
      status: success | failed | skipped
      files_copied:
        - source: "{network_dir}/skills/{network_id}-rules.md"
          target: ".cursor/skills/{network_id}-rules/{network_id}-rules.md"
          verified: true
    - platform: claude
      platform_root: ".claude"
      target_path: ".claude/skills/{network_id}-rules/"
      status: success | failed | skipped
      files_copied: []
  overall_status: all_success | partial | failed | skipped

约束

• 不修改 Skill 文件内容，仅复制
• 各平台结构一致，无需格式转换
• 平台目录下直接覆盖，不归档（归档由 bkn-rules 在源头 {network_dir}/skills/_archived/ 统一管理）
• 跳过（选 N）不阻断后续流程
• 分发失败不阻断平台发布（openbkn skill register）
• 若 skill_artifact_path 为空（无规则可分发），输出 skipped: no_skills 并停止