bkn-skillgen

$npx mdskill add kweaver-ai/kweaver-dip/bkn-skillgen

Analyzes skill gaps and generates new skill drafts when needed.

  • Identifies capability gaps between user requests and existing skills.
  • Reads current skill inventory and gap checklist from references.
  • Compares requirements against existing skills to decide reuse or create.
  • Outputs reuse plan or generates skill spec, SKILL.md, and test triggers.

SKILL.md

.github/skills/bkn-skillgenView on GitHub ↗
---
name: bkn-skillgen
description: 分析技能包能力缺口,判断是否需要新 skill,生成草案。
---

# 能力缺口分析

公约:`../_shared/contract.md`

## 做什么

分析当前 skill 包的能力缺口,判断复用还是新建,需要时生成 skill 草案。

## 输入

- `user_input`:用户描述的能力诉求
- `current_skill_inventory`(可选):已有 skill 清单,缺省时主动读取
- `generation_goal`:analyze_only / generate_draft / write_files

## 流程

1. 建立 `current_skill_inventory`
2. 按 `references/gap-checklist.md` 拆解需求
3. 覆盖比对 → 已覆盖 / 部分覆盖 / 缺失
4. 无显著缺口 → 输出 `reuse_plan`,停止
5. 有缺口 → 聚类为候选 skill → 产出 Spec + SKILL.md + 触发测试

## 输出

```yaml
capability_gap_analysis: {user_goal, need_new_skill}
reuse_plan: {recommended_existing_skills, why_not_enough}
skill_generation_plan:
  candidate_skills:
    - skill_name: ""
      role: ""
      boundaries: {does, does_not}
generated_skill_artifacts:
  - skill_name: ""
    skill_md_draft: ""
    trigger_test_set: {should_trigger, should_not_trigger}
```

## 约束

- 先判断是否真需要新 skill,现有覆盖 80%+ 优先建议优化
- 每个新 skill 必须写清"何时用/不用" + 至少 1 负例
- 不改写外部能力(bkn-kweaver / data-semantic)

## 保留名称(禁止新建同名)

`bkn-router`、`bkn-domain`、`bkn-extract`、`bkn-doctor`、`bkn-rules`、`bkn-draft`、`bkn-env`、`bkn-bind`、`bkn-map`、`bkn-backfill`、`bkn-test`、`bkn-review`、`bkn-anchor`、`bkn-report`、`bkn-skillgen`、`bkn-distribute`、`bkn-kweaver`、`bkn-archive`

## 参考

- `references/gap-checklist.md`

More from kweaver-ai/kweaver-dip