$npx -y skills add kweaver-ai/kweaver-dip --skill bkn-skillgen分析技能包能力缺口,判断是否需要新 skill,生成草案。
| 1 | # 能力缺口分析 |
| 2 | |
| 3 | 公约:`../_shared/contract.md` |
| 4 | |
| 5 | ## 做什么 |
| 6 | |
| 7 | 分析当前 skill 包的能力缺口,判断复用还是新建,需要时生成 skill 草案。 |
| 8 | |
| 9 | ## 输入 |
| 10 | |
| 11 | - `user_input`:用户描述的能力诉求 |
| 12 | - `current_skill_inventory`(可选):已有 skill 清单,缺省时主动读取 |
| 13 | - `generation_goal`:analyze_only / generate_draft / write_files |
| 14 | |
| 15 | ## 流程 |
| 16 | |
| 17 | 1. 建立 `current_skill_inventory` |
| 18 | 2. 按 `references/gap-checklist.md` 拆解需求 |
| 19 | 3. 覆盖比对 → 已覆盖 / 部分覆盖 / 缺失 |
| 20 | 4. 无显著缺口 → 输出 `reuse_plan`,停止 |
| 21 | 5. 有缺口 → 聚类为候选 skill → 产出 Spec + SKILL.md + 触发测试 |
| 22 | |
| 23 | ## 输出 |
| 24 | |
| 25 | ```yaml |
| 26 | capability_gap_analysis: {user_goal, need_new_skill} |
| 27 | reuse_plan: {recommended_existing_skills, why_not_enough} |
| 28 | skill_generation_plan: |
| 29 | candidate_skills: |
| 30 | - skill_name: "" |
| 31 | role: "" |
| 32 | boundaries: {does, does_not} |
| 33 | generated_skill_artifacts: |
| 34 | - skill_name: "" |
| 35 | skill_md_draft: "" |
| 36 | trigger_test_set: {should_trigger, should_not_trigger} |
| 37 | ``` |
| 38 | |
| 39 | ## 约束 |
| 40 | |
| 41 | - 先判断是否真需要新 skill,现有覆盖 80%+ 优先建议优化 |
| 42 | - 每个新 skill 必须写清"何时用/不用" + 至少 1 负例 |
| 43 | - 不改写外部能力(bkn-kweaver / data-semantic) |
| 44 | |
| 45 | ## 保留名称(禁止新建同名) |
| 46 | |
| 47 | `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` |
| 48 | |
| 49 | ## 参考 |
| 50 | |
| 51 | - `references/gap-checklist.md` |