bkn-review

Name: bkn-review
Author: kweaver-ai

309stars53forks

How to install bkn-review?

kweaver-ai/kweaver-dip/bkn-review

$npx -y skills add kweaver-ai/kweaver-dip --skill bkn-review

Installs into the current project.

Summary

网络质量评审、评分与调整分发。闭环关键。

Files · 1

View on GitHub

SKILL.md

1	# 网络评审
2
3	公约：`../_shared/contract.md`
4
5	## 做什么
6
7	分析测试结果，计算质量评分，判定通过或需要调整，分发调整任务到对应 skill。
8
9	插件降级说明：当 `plugin_availability.rules == unavailable` 或 `plugin_availability.test == unavailable` 时，评分维度自动降级。
10
11	## 输入
12
13	- 测试执行结果（`bkn-test` 输出；若 test 插件不可用则为空）
14	- 当前网络状态（对象/关系/绑定/映射汇总）
15	- 业务规则清单（如有；若 rules 插件不可用则为空）
16	- `plugin_availability`：来自 `pipeline_state.yaml`
17
18	## 质量评分
19
20	\| 维度 \| 检查内容 \| 权重 \|
21	\|------\|---------\|------\|
22	\| 结构完整性 \| 每个对象有主键、有描述、属性非空 \| 20% \|
23	\| 关系健全性 \| 关系两端对象存在、方向一致、无悬空引用、属性引用存在（Source/Target Property 存在于对应对象 Data Properties） \| 20% \|
24	\| 绑定率 \| bound_objects / total_platform_objects \| 20% \|
25	\| 映射覆盖率 \| (mapped + waived) / total_platform_properties \| 20% \|
26	\| 规则覆盖率 \| 有规则的对象数 / 总对象数；拆分为子项（见下方） \| 10% \|
27	\| 测试通过率 \| passed_cases / total_cases \| 10% \|
28
29	### 规则覆盖率子项
30
31	规则覆盖率维度由两个子项组成：
32
33	\| 子项 \| 检查内容 \| 占规则覆盖率权重 \|
34	\|------\|---------\|-----------------\|
35	\| 规则覆盖广度 \| 有规则的对象数 / 总对象数 \| 60% \|
36	\| Skill 文件质量 \| 读取 `bkn-rules` 的 `skill_self_check`，5 项自检全部 pass 为 100%，每项 fail 扣 20% \| 40% \|
37
38	- `skill_self_check` 来自 `bkn-rules` 输出的 `skill_self_check` 字段
39	- 若 `bkn-rules` 未输出 `skill_self_check`（旧版本或插件不可用），Skill 文件质量子项记为 0
40
41	### 插件降级评分逻辑
42
43	当 `plugin_availability.rules == unavailable` 时：
44	- 规则覆盖率维度：Skill 文件质量子项权重降为 0，仅保留规则覆盖广度子项（权重 10%）
45	- 若 rules 插件完全不可用导致无规则数据，规则覆盖率维度标记为 N/A，不参与评分
46	- 剩余维度权重等比放大：结构 22.2%、关系 22.2%、绑定 22.2%、映射 22.2%、测试 11.1%
47
48	当 `plugin_availability.test == unavailable` 时：
49	- 测试通过率维度：标记为 N/A，不参与评分
50	- 剩余维度权重等比放大：结构 22.2%、关系 22.2%、绑定 22.2%、映射 22.2%、规则 11.1%
51
52	双重降级（rules 和 test 都不可用）：
53	- 规则覆盖率 + 测试通过率均标记为 N/A
54	- 剩余维度权重等比放大：结构 25%、关系 25%、绑定 25%、映射 25%
55
56	### 存储位置过滤
57
58	- `存储位置: local` 的对象不参与绑定率和映射覆盖率计算
59	- 绑定率分母只计算 `platform` 对象数量
60	- 映射覆盖率分母只计算 `platform` 对象的属性数量
61	- local 对象仍需通过结构完整性检查（有主键、有描述、属性非空）
62
63	- 综合分 >= 80 → 通过，可推送
64	- 60-80 → 有风险，需用户确认
65	- < 60 → 建议修复
66
67	### `bind_mode == deferred` 时的评分调整
68
69	当 `bkn-env` 判定 `bind_mode: deferred`（无可用数据视图）时：
70	- 绑定率（20%）和映射覆盖率（20%）标记为 N/A，不参与评分
71	- 剩余维度权重等比放大：结构完整性 33%、关系健全性 33%、规则覆盖率 17%、测试通过率 17%
72
73	### 一票否决
74
75	以下情况无论综合分如何，verdict 强制为 fail：
76	- `bind_mode == full` 且绑定率 < 30%（有视图但几乎没绑上），且 platform 对象数量 >= 3
77	- 结构完整性维度 < 50%（基础质量不达标）
78
79	### 外部校验锚点
80
81	以下维度必须包含外部验证数据，不可纯粹依赖 Agent 自评：
82	- 结构完整性：`kweaver bkn validate` 通过 → 该维度底线 60%；未通过 → 上限 40%
83	- 绑定率：来自 `bkn-bind` 的 `binding_summary` 实际数值
84	- 映射覆盖率：来自 `bkn-map` 的 `mapping_gate_summary` 实际数值
85	- 关系健全性-属性引用：`_shared/prepush-validation.md` 预检结果，有错误则该维度分数减半
86
87	## 调整分发
88
89	不达标时，按失败根因分发到对应 skill：
90
91	\| 根因 \| 调整 skill \|
92	\|------\|-----------\|
93	\| 对象/关系问题 \| `bkn-doctor` → `bkn-draft` \|
94	\| 绑定问题 \| `bkn-bind` → `bkn-map` → `bkn-backfill` \|
95	\| 规则缺失 \| `../_plugins/bkn-rules/SKILL.md`（仅当 `plugin_availability.rules == available` 时） \|
96	\| 属性映射不足 \| `bkn-map` \|
97
98	插件不可用时的分发调整：
99	- 若 `plugin_availability.rules == unavailable` 且根因涉及"规则缺失"：
100	- 不分发到 bkn-rules，改为输出提示"规则插件不可用，请手动补充业务规则或安装插件"
101	- 在 `adjustment_plan` 中标记 `target_skill: none(plugin_unavailable)`
102
103	每轮调整必须有 diff（改了什么）。最多自动循环 3 轮，超过则暂停让用户介入。
104
105	## 输出
106
107	```yaml
108	quality_score: 0
109	score_breakdown: {structure, relations, binding, mapping, rules, tests}
110	plugin_degraded_dimensions: [] # 记录因插件不可用而降级的维度，如 ["rules", "tests"]
111	verdict: pass \| warn \| fail
112	adjustment_plan:
113	- target_skill: ""
114	reason: ""
115	suggested_action: ""
116	iteration: {current_round, max_rounds, score_history}
117	```
118
119	## 约束
120
121	- 评分必须基于实际测试数据，不编造
122	- 不替代具体 skill 做修复，只做诊断和分发
123	- 插件不可用时在输出中明确标注降级原因

People who liked this also viewed

6 picks

Type

find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 20262.6M27k
grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026633k182k
vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026573k29k
improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026522k182k
setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026454k182k
triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026424k182k

bkn-review

309stars53forks

View on GitHub

How to install bkn-review?

kweaver-ai/kweaver-dip/bkn-review

$npx -y skills add kweaver-ai/kweaver-dip --skill bkn-review

Installs into the current project.

Summary

网络质量评审、评分与调整分发。闭环关键。

Files · 1

View on GitHub

SKILL.md

1	# 网络评审
2
3	公约：`../_shared/contract.md`
4
5	## 做什么
6
7	分析测试结果，计算质量评分，判定通过或需要调整，分发调整任务到对应 skill。
8
9	插件降级说明：当 `plugin_availability.rules == unavailable` 或 `plugin_availability.test == unavailable` 时，评分维度自动降级。
10
11	## 输入
12
13	- 测试执行结果（`bkn-test` 输出；若 test 插件不可用则为空）
14	- 当前网络状态（对象/关系/绑定/映射汇总）
15	- 业务规则清单（如有；若 rules 插件不可用则为空）
16	- `plugin_availability`：来自 `pipeline_state.yaml`
17
18	## 质量评分
19
20	\| 维度 \| 检查内容 \| 权重 \|
21	\|------\|---------\|------\|
22	\| 结构完整性 \| 每个对象有主键、有描述、属性非空 \| 20% \|
23	\| 关系健全性 \| 关系两端对象存在、方向一致、无悬空引用、属性引用存在（Source/Target Property 存在于对应对象 Data Properties） \| 20% \|
24	\| 绑定率 \| bound_objects / total_platform_objects \| 20% \|
25	\| 映射覆盖率 \| (mapped + waived) / total_platform_properties \| 20% \|
26	\| 规则覆盖率 \| 有规则的对象数 / 总对象数；拆分为子项（见下方） \| 10% \|
27	\| 测试通过率 \| passed_cases / total_cases \| 10% \|
28
29	### 规则覆盖率子项
30
31	规则覆盖率维度由两个子项组成：
32
33	\| 子项 \| 检查内容 \| 占规则覆盖率权重 \|
34	\|------\|---------\|-----------------\|
35	\| 规则覆盖广度 \| 有规则的对象数 / 总对象数 \| 60% \|
36	\| Skill 文件质量 \| 读取 `bkn-rules` 的 `skill_self_check`，5 项自检全部 pass 为 100%，每项 fail 扣 20% \| 40% \|
37
38	- `skill_self_check` 来自 `bkn-rules` 输出的 `skill_self_check` 字段
39	- 若 `bkn-rules` 未输出 `skill_self_check`（旧版本或插件不可用），Skill 文件质量子项记为 0
40
41	### 插件降级评分逻辑
42
43	当 `plugin_availability.rules == unavailable` 时：
44	- 规则覆盖率维度：Skill 文件质量子项权重降为 0，仅保留规则覆盖广度子项（权重 10%）
45	- 若 rules 插件完全不可用导致无规则数据，规则覆盖率维度标记为 N/A，不参与评分
46	- 剩余维度权重等比放大：结构 22.2%、关系 22.2%、绑定 22.2%、映射 22.2%、测试 11.1%
47
48	当 `plugin_availability.test == unavailable` 时：
49	- 测试通过率维度：标记为 N/A，不参与评分
50	- 剩余维度权重等比放大：结构 22.2%、关系 22.2%、绑定 22.2%、映射 22.2%、规则 11.1%
51
52	双重降级（rules 和 test 都不可用）：
53	- 规则覆盖率 + 测试通过率均标记为 N/A
54	- 剩余维度权重等比放大：结构 25%、关系 25%、绑定 25%、映射 25%
55
56	### 存储位置过滤
57
58	- `存储位置: local` 的对象不参与绑定率和映射覆盖率计算
59	- 绑定率分母只计算 `platform` 对象数量
60	- 映射覆盖率分母只计算 `platform` 对象的属性数量
61	- local 对象仍需通过结构完整性检查（有主键、有描述、属性非空）
62
63	- 综合分 >= 80 → 通过，可推送
64	- 60-80 → 有风险，需用户确认
65	- < 60 → 建议修复
66
67	### `bind_mode == deferred` 时的评分调整
68
69	当 `bkn-env` 判定 `bind_mode: deferred`（无可用数据视图）时：
70	- 绑定率（20%）和映射覆盖率（20%）标记为 N/A，不参与评分
71	- 剩余维度权重等比放大：结构完整性 33%、关系健全性 33%、规则覆盖率 17%、测试通过率 17%
72
73	### 一票否决
74
75	以下情况无论综合分如何，verdict 强制为 fail：
76	- `bind_mode == full` 且绑定率 < 30%（有视图但几乎没绑上），且 platform 对象数量 >= 3
77	- 结构完整性维度 < 50%（基础质量不达标）
78
79	### 外部校验锚点
80
81	以下维度必须包含外部验证数据，不可纯粹依赖 Agent 自评：
82	- 结构完整性：`kweaver bkn validate` 通过 → 该维度底线 60%；未通过 → 上限 40%
83	- 绑定率：来自 `bkn-bind` 的 `binding_summary` 实际数值
84	- 映射覆盖率：来自 `bkn-map` 的 `mapping_gate_summary` 实际数值
85	- 关系健全性-属性引用：`_shared/prepush-validation.md` 预检结果，有错误则该维度分数减半
86
87	## 调整分发
88
89	不达标时，按失败根因分发到对应 skill：
90
91	\| 根因 \| 调整 skill \|
92	\|------\|-----------\|
93	\| 对象/关系问题 \| `bkn-doctor` → `bkn-draft` \|
94	\| 绑定问题 \| `bkn-bind` → `bkn-map` → `bkn-backfill` \|
95	\| 规则缺失 \| `../_plugins/bkn-rules/SKILL.md`（仅当 `plugin_availability.rules == available` 时） \|
96	\| 属性映射不足 \| `bkn-map` \|
97
98	插件不可用时的分发调整：
99	- 若 `plugin_availability.rules == unavailable` 且根因涉及"规则缺失"：
100	- 不分发到 bkn-rules，改为输出提示"规则插件不可用，请手动补充业务规则或安装插件"
101	- 在 `adjustment_plan` 中标记 `target_skill: none(plugin_unavailable)`
102
103	每轮调整必须有 diff（改了什么）。最多自动循环 3 轮，超过则暂停让用户介入。
104
105	## 输出
106
107	```yaml
108	quality_score: 0
109	score_breakdown: {structure, relations, binding, mapping, rules, tests}
110	plugin_degraded_dimensions: [] # 记录因插件不可用而降级的维度，如 ["rules", "tests"]
111	verdict: pass \| warn \| fail
112	adjustment_plan:
113	- target_skill: ""
114	reason: ""
115	suggested_action: ""
116	iteration: {current_round, max_rounds, score_history}
117	```
118
119	## 约束
120
121	- 评分必须基于实际测试数据，不编造
122	- 不替代具体 skill 做修复，只做诊断和分发
123	- 插件不可用时在输出中明确标注降级原因

People who liked this also viewed

6 picks

Type