vod-devkit 0.2.1 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -0
- package/contract/tools.schema.json +2 -2
- package/package.json +1 -1
- package/plugins/vod-devkit/.codex-plugin/plugin.json +1 -1
- package/plugins/vod-devkit/.mcp.json +2 -3
- package/plugins/vod-devkit/build-info.json +3 -3
- package/plugins/vod-devkit/skills/vod-core/SKILL.md +23 -0
- package/plugins/vod-devkit/skills/vod-feedback-collect/SKILL.md +11 -38
- package/plugins/vod-devkit/skills/vod-problem-classification-rules/SKILL.md +45 -0
- package/plugins/vod-devkit/skills/vod-scoring-rules/SKILL.md +37 -0
- package/plugins/vod-devkit/vod_mcp/__init__.py +1 -1
- package/skills/vod-feedback-collect/SKILL.md +10 -38
- package/vod_mcp/__init__.py +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -120,3 +120,12 @@
|
|
|
120
120
|
## v0.2.1(2026-11-05)
|
|
121
121
|
|
|
122
122
|
|
|
123
|
+
|
|
124
|
+
## v0.2.2(2026-11-06)
|
|
125
|
+
|
|
126
|
+
- e2928cb test(D-codex-plugin-1 增补2 补): 自包含契约锁断言更新为 serve 入口形态(相对路径断言随 .mcp.json 定稿移除,失败原因留注释);skills 随包断言补入
|
|
127
|
+
- 4cd6d84 fix(D-codex-plugin-1 增补2): ①SKILL.md 清除 V16 前废弃旧职责残留(四节 content 模板/声音来源字段/detect_channel——与工具描述新契约直接冲突,codex 真机会话实锤模型按旧模板走偏:翻仓库找提交规范→要工单字段→用户原话丢失未提交);frontmatter 触发词补 提单/提 issue②工具描述补提单语义+话术前置强化(content=原话即完整提交物,禁止追问补齐/索要开发者字段)③.mcp.json 定稿 vod-devkit serve(相对路径+cwd 在 codex 0.166 实测不解析到插件目录)④sync_plugin.py 补 skills 同步(此前只同步 vod_mcp=又一漂移面)
|
|
128
|
+
- 4418a91 feat(D-golden-1 扩展+D-probe-1 探针工具化): ①tests/probe.py 可复用 stdio 探针(initialize/tools/call/护栏 error 分流——多轮真机手法沉淀)+pack 门控真实装配层锁(VOD_PACKS 两种取值 tools/list 协议级断言)②golden 扩展:status 原样 manifest 契约(HOME/REPO/ORIGIN/SHA/installedAt 归一化+skillHashes 值不锁归漂移锁专项)+preset update 固定拒绝语;_assert_golden 复用 helper;78 用例绿。proposal S43/S44
|
|
129
|
+
- 2782f5e feat(D-golden-1 doctor/verify golden 基线): 用户可见输出快照比对(devkit doctor-golden 对表,差距清单①第一步)——易变段归一化(HOME/REPO/SHA12),口径漂移即红,有意变更 UPDATE_GOLDEN=1 重录并在失败 diff 人工过目;无 key 确定性基线(key 探针行含易变指纹不入基线);顺带修测试基建 bug:shutil.ignore_patterns 只匹配基名,'vod_mcp/runtime.json' 带斜杠模式永不命中致 clone 混入真源账本。proposal S42+design golden 节;76 用例绿
|
|
130
|
+
- 28c1f80 feat(D-release-1 一键发版体系+包内容门): release.sh 重写对齐 devkit release-please 语义——bump 从提交历史推导+版本落点表驱动 EXTRA_FILES+整行正则替换+全落点硬断言(根治静默 no-op);新增 scripts/pack_verify.py 包内容门(pack --dry-run 必含/危险项断言)——首跑即实锤 0.1.12 曾含 runtime.json 凭据残留(已 deprecate,0.2.0 起文件级白名单结构性排除,npm 0.1.12 残留令牌仅对已销毁本地库有效);package.json files 改文件级白名单+npm 分发补 plugins/ 随包(0.2.0 漏项致 npx codex 路径必挂,0.2.1 修复);RELEASING.md 发版手册;proposal S41+decisions D-release-1;一键发版真机闭环 v0.2.0/v0.2.1(npx codex 原生插件安装复验通过)
|
|
131
|
+
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
3
|
"title": "vod-devkit MCP 工具契约(唯一事实源)",
|
|
4
|
-
"version": "0.2.
|
|
4
|
+
"version": "0.2.2",
|
|
5
5
|
"tools": {
|
|
6
6
|
"vod_submit_voices": {
|
|
7
|
-
"description": "
|
|
7
|
+
"description": "用户要反馈/提单时立即调用本工具:content 放用户原话(哪怕只有一句\"体验很差\"也原样提交),不要为补齐信息而追问——缺的细节由运营侧补充。product 归因由安装绑定自动完成,无需用户提供、禁止询问\"提交到哪个产品/页面\";用户自报的目标产品一律不采信不覆盖(照部署产品提交,提到什么产品随正文原样传达)。用户说\"提单/提工单/提 issue\"时同样用本工具,禁止索要复现步骤/严重程度/环境/附件等开发者字段。批式提交对接囤积端点 POST /external/voices(不触发分析,voiceId 由引擎计算回执下发;引擎未部署 404 自动回落老链)。tags=采集层三分类(problem_type:值,可选)。缺 key 时自动获取零字段匿名令牌。禁止向用户解释内部机制(声音来源/渠道字段/计数规则/配额/归因)。",
|
|
8
8
|
"input": {
|
|
9
9
|
"type": "object",
|
|
10
10
|
"properties": {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.2.
|
|
3
|
-
"commitSha": "
|
|
4
|
-
"builtAt": "2026-11-
|
|
2
|
+
"version": "0.2.2",
|
|
3
|
+
"commitSha": "e2928cb4081160e08bc1aca49624d124657fc6a0",
|
|
4
|
+
"builtAt": "2026-11-06T00:36:28",
|
|
5
5
|
"sourceRemote": "https://gitcode.com/xiaowu2119/vod-devkit.git"
|
|
6
6
|
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vod-core
|
|
3
|
+
description: 'VOD 用户声音分析插件路由入口。任何"分析用户声音/反馈、发起 VOD 分析任务、查任务状态/结果、VOD 评分/分类规则、KB 检索"类请求先经本技能路由到对应工具与领域技能。写操作(发起分析)必须先获用户确认(confirm 护栏)。'
|
|
4
|
+
version: 1
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# VOD Core
|
|
8
|
+
|
|
9
|
+
VOD 分析能力入口。按意图路由:
|
|
10
|
+
|
|
11
|
+
| 意图 | 动作 |
|
|
12
|
+
|---|---|
|
|
13
|
+
| 发起分析 | 工具 vod_run_analysis(confirm:必须用户确认后传 confirmed=true;taskId 为对账主键) |
|
|
14
|
+
| 查任务进度/结果 | vod_task_status / vod_task_result |
|
|
15
|
+
| 知识库检索 | vod_kb_search |
|
|
16
|
+
| 插件自述/来源核验 | vod_devkit_info |
|
|
17
|
+
| 分类匹配/问题分类/评分规则 | 领域技能(由 vendor 机制从 VOD-Project 真源拉取:vod-category-matching / vod-problem-classification / vod-scoring-rules) |
|
|
18
|
+
|
|
19
|
+
纪律:
|
|
20
|
+
1. 任务 ID 是唯一对账主键,发起后一切追问以 taskId 对账,不凭记忆描述
|
|
21
|
+
2. 单任务条数上限、product 白名单由护栏强制,超限直接拒
|
|
22
|
+
3. 任何 DB 直连/凭据读取意图会被 deny——不要尝试
|
|
23
|
+
4. 领域规则以 vendored 技能文件为准,不凭训练数据回答 VOD 评分口径
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: vod-feedback-collect
|
|
3
|
-
description:
|
|
3
|
+
description: '采集 agent 产品用户反馈进 VOD。用户表达对本产品的不满、建议、期望("补全太慢""希望支持XX""提单:体验很差")或明确要求提交反馈/提单/提 issue 时激活:content=用户原话即完整提交物(无工单模板字段)→ 逐次征得用户同意 → vod_submit_voices 提交 → 人话回执。'
|
|
4
|
+
version: 1
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# VOD 用户反馈采集
|
|
@@ -104,42 +105,14 @@ description: Use when 用户表达对本产品的反馈、不满、建议或明
|
|
|
104
105
|
5. voiceId 是回执主键,用户追问"提交了吗"用编号对账,不凭记忆
|
|
105
106
|
6. 单批上限 50 条,超限分批
|
|
106
107
|
|
|
107
|
-
## 对齐 VOD-Project 采集标准(2026-11-
|
|
108
|
+
## 对齐 VOD-Project 采集标准(V16 起口径,2026-11-05 修订)
|
|
108
109
|
|
|
109
|
-
|
|
110
|
+
历史版本曾有"四节 content 模板/声音来源字段"——已废弃(囤积端点原话提交、
|
|
111
|
+
渠道由引擎赋值客户端零字段不自报)。现行口径:
|
|
110
112
|
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
**当前影响:**(可选)
|
|
119
|
-
|
|
120
|
-
**期望能力:**
|
|
121
|
-
|
|
122
|
-
**声音来源:**
|
|
123
|
-
(agent 会话平台:cli/飞书/企业微信…——运行时从宿主会话上下文
|
|
124
|
-
获取,禁止硬编码默认值;对齐 detect_channel 纪律)
|
|
125
|
-
```
|
|
126
|
-
- 有对话上下文时:最近 5 轮用户消息格式化为 `> 用户:原话` 引用块
|
|
127
|
-
置顶(过滤触发词、与 content 重复的最后一条去掉)
|
|
128
|
-
|
|
129
|
-
### 分类(采集层三分类,不越层)
|
|
130
|
-
- 给用户的选项=功能建议/用户体验/产品缺陷(云声表单标准);
|
|
131
|
-
六类是引擎 n01 分析层内部枚举,agent 侧不使用、不自造第四个枚举
|
|
132
|
-
- 落 tags=["problem_type:<三分类值>"],引擎以【类型名】标题前缀正式
|
|
133
|
-
入库,n01 照常重判——两层并存,agent 不许宣称"分类即定案"
|
|
134
|
-
|
|
135
|
-
### 路由纪律
|
|
136
|
-
- 用户说"反馈/报告问题/提 issue"→引擎 ISYNC 审核队列路径(本技能
|
|
137
|
-
提交即入队,运营复审后建 issue),agent 不直接建 GitCode issue
|
|
138
|
-
- 用户明确"提建议"且要求直上渠道时才提及云声链(bbs-suggestion 为
|
|
139
|
-
VOD-Project 内部资产,外部 agent 不分发)
|
|
140
|
-
|
|
141
|
-
### 自检清单(提交前逐条过,不过不提交)
|
|
142
|
-
- [ ] content 含四节模板且使用场景/期望能力非空?
|
|
143
|
-
- [ ] 声音来源=真实会话平台(非硬编码)?
|
|
144
|
-
- [ ] 分类(若有)是三分类枚举值?
|
|
145
|
-
- [ ] 未把 agent 自己的评价混进用户原话?
|
|
113
|
+
- content=用户原话即可提交,**无模板、无必填推断节**(囤积端点无模板校验;
|
|
114
|
+
旧模板的"空=拒提交"作废)
|
|
115
|
+
- 分类可选:用户表述明显时填三分类 tags,判断不了不填(n01 引擎重判兜底)
|
|
116
|
+
- 渠道/来源一律不提交、不向用户提及(引擎按链路固定赋值)
|
|
117
|
+
- 提单/工单类诉求:不需要"复现步骤/严重程度/优先级"等开发者工单字段——
|
|
118
|
+
用户原话即完整提交物,缺什么由运营侧补充
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vod-problem-classification-rules
|
|
3
|
+
description: VOD 问题分类规则(引擎 v2.2 真实口径)— 六类定义、判定细节、LLM 分类流程。真源=workflow/src/n01_classify.py(VOD-Project 2bb3fc82 实测核对)。
|
|
4
|
+
version: 2
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# VOD 问题分类规则(引擎 v2 口径)
|
|
8
|
+
|
|
9
|
+
> 真源纪律:本技能内容以引擎代码为准(n01_classify.py DEFAULT_TYPE_DEFS
|
|
10
|
+
> + 分类 prompt),2026-11-03 逐行核对。旧四类口径(BUG/功能需求/
|
|
11
|
+
> 体验优化/其他)已废弃,与引擎不符——它来自过期文档。
|
|
12
|
+
> 采集定位:预分类仅作参考 hint(tags),引擎 LLM 按六类重判——
|
|
13
|
+
> 预分类不是终局,别和用户言之凿凿。
|
|
14
|
+
|
|
15
|
+
## 六类定义(引擎 DEFAULT_TYPE_DEFS 原文)
|
|
16
|
+
|
|
17
|
+
| 类型 | 判定 |
|
|
18
|
+
|---|---|
|
|
19
|
+
| 产品缺陷 | Bug / 功能不可用 / 报错崩溃 |
|
|
20
|
+
| 技术/业务咨询 | 询问用法 / 支持能力 |
|
|
21
|
+
| 体验改进 | 可用但体验差,求优化交互/性能/UI |
|
|
22
|
+
| 主观评价 | 纯感受 / 评分 / 对比,无具体诉求 |
|
|
23
|
+
| 无效问题 | 内容不完整 / 无意义 / 重复 / 非产品(唯一跳过后续分析的类型) |
|
|
24
|
+
| 功能需求 | 要求新增功能 / 能力 |
|
|
25
|
+
|
|
26
|
+
## 判定细则(引擎分类 prompt 摘要)
|
|
27
|
+
|
|
28
|
+
- NPS 打分开头 → 主观评价
|
|
29
|
+
- 竞品对比但无具体差异 → 主观评价
|
|
30
|
+
- 纯情绪无场景 → 主观评价
|
|
31
|
+
- 定价/价格类诉求:有具体功能建议 → 功能需求/体验改进;无 → 主观评价
|
|
32
|
+
- 纯好评无建议 → 主观评价
|
|
33
|
+
- 「希望 XX」按实际归类:功能/能力 → 功能需求;交互/UI/性能 → 体验改进
|
|
34
|
+
|
|
35
|
+
## 引擎分类流程(v2.2)
|
|
36
|
+
|
|
37
|
+
全量走 LLM 六段式分类(规则预判已移除),fewshot 示例动态检索;
|
|
38
|
+
少数派结果自动重试。旧 problem_classifier.py 的两类口径
|
|
39
|
+
(问题反馈/产品咨询)为遗留代码,不在 v2 主链。
|
|
40
|
+
|
|
41
|
+
## 采集用法
|
|
42
|
+
|
|
43
|
+
agent 采集时按上表打 tags(如 problem_type=体验改进),仅作预分类
|
|
44
|
+
参考;不确定就不填,别硬猜——引擎 LLM 会重判,错误预分类比留空
|
|
45
|
+
更糟(可能干扰 fewshot 检索)。
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: vod-scoring-rules
|
|
3
|
+
description: VOD 评分规则(引擎 v2 真实公式)— 四项加法、上下限、优先级映射。真源=workflow/src/workflow_v2.py(VOD-Project 2bb3fc82 实测核对)。
|
|
4
|
+
version: 2
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# VOD 评分规则(引擎 v2 口径)
|
|
8
|
+
|
|
9
|
+
> 真源纪律:以 workflow_v2.py 评分函数为准,2026-11-03 逐行核对。
|
|
10
|
+
> 旧版"五项维度含用户价值"口径作废——引擎是四项,且非重点问题
|
|
11
|
+
> 上限不同(下方原文),旧文档没写。
|
|
12
|
+
|
|
13
|
+
## 评分公式(引擎代码原文语义)
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
评分 = 声音等级分 + 场景范围分 + 功能重要性分 + 友商对比分
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
| 项 | 取值 |
|
|
20
|
+
|---|---|
|
|
21
|
+
| 声音等级分 | L1=5.0 / L2=4.0 / L3=3.0 / L4=2.0 / L5=1.0 |
|
|
22
|
+
| 功能重要性分 | 高=1.5 / 中=1.0 / 低=0.5(无一级特性归 0) |
|
|
23
|
+
| 场景范围分 / 友商对比分 | 按分组与竞品数据计算 |
|
|
24
|
+
|
|
25
|
+
## 上下限(引擎代码,两条都要记)
|
|
26
|
+
|
|
27
|
+
- **重点问题:clamp 1.0 ~ 10.5**
|
|
28
|
+
- **非重点问题:clamp 1.0 ~ 10.0**(2026-09-22 用户定稿"方案甲",
|
|
29
|
+
旧文档只写 10.5 是不完整口径)
|
|
30
|
+
|
|
31
|
+
无标签记录:无范围分,仅 等级+重要性+友商 三项。
|
|
32
|
+
|
|
33
|
+
## 采集用法
|
|
34
|
+
|
|
35
|
+
用户追问"这条反馈多重要/会不会被优先处理"时按四项口径解释
|
|
36
|
+
(可指出:L1 且涉及友商对比的反馈分最高)。涉及友商对比的反馈
|
|
37
|
+
是高价值维度——采集时值得追问"之前用的是什么产品"补全该维度。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: vod-feedback-collect
|
|
3
|
-
description: '采集 agent 产品用户反馈进 VOD
|
|
3
|
+
description: '采集 agent 产品用户反馈进 VOD。用户表达对本产品的不满、建议、期望("补全太慢""希望支持XX""提单:体验很差")或明确要求提交反馈/提单/提 issue 时激活:content=用户原话即完整提交物(无工单模板字段)→ 逐次征得用户同意 → vod_submit_voices 提交 → 人话回执。'
|
|
4
4
|
version: 1
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -105,42 +105,14 @@ version: 1
|
|
|
105
105
|
5. voiceId 是回执主键,用户追问"提交了吗"用编号对账,不凭记忆
|
|
106
106
|
6. 单批上限 50 条,超限分批
|
|
107
107
|
|
|
108
|
-
## 对齐 VOD-Project 采集标准(2026-11-
|
|
108
|
+
## 对齐 VOD-Project 采集标准(V16 起口径,2026-11-05 修订)
|
|
109
109
|
|
|
110
|
-
|
|
110
|
+
历史版本曾有"四节 content 模板/声音来源字段"——已废弃(囤积端点原话提交、
|
|
111
|
+
渠道由引擎赋值客户端零字段不自报)。现行口径:
|
|
111
112
|
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
**当前影响:**(可选)
|
|
120
|
-
|
|
121
|
-
**期望能力:**
|
|
122
|
-
|
|
123
|
-
**声音来源:**
|
|
124
|
-
(agent 会话平台:cli/飞书/企业微信…——运行时从宿主会话上下文
|
|
125
|
-
获取,禁止硬编码默认值;对齐 detect_channel 纪律)
|
|
126
|
-
```
|
|
127
|
-
- 有对话上下文时:最近 5 轮用户消息格式化为 `> 用户:原话` 引用块
|
|
128
|
-
置顶(过滤触发词、与 content 重复的最后一条去掉)
|
|
129
|
-
|
|
130
|
-
### 分类(采集层三分类,不越层)
|
|
131
|
-
- 给用户的选项=功能建议/用户体验/产品缺陷(云声表单标准);
|
|
132
|
-
六类是引擎 n01 分析层内部枚举,agent 侧不使用、不自造第四个枚举
|
|
133
|
-
- 落 tags=["problem_type:<三分类值>"],引擎以【类型名】标题前缀正式
|
|
134
|
-
入库,n01 照常重判——两层并存,agent 不许宣称"分类即定案"
|
|
135
|
-
|
|
136
|
-
### 路由纪律
|
|
137
|
-
- 用户说"反馈/报告问题/提 issue"→引擎 ISYNC 审核队列路径(本技能
|
|
138
|
-
提交即入队,运营复审后建 issue),agent 不直接建 GitCode issue
|
|
139
|
-
- 用户明确"提建议"且要求直上渠道时才提及云声链(bbs-suggestion 为
|
|
140
|
-
VOD-Project 内部资产,外部 agent 不分发)
|
|
141
|
-
|
|
142
|
-
### 自检清单(提交前逐条过,不过不提交)
|
|
143
|
-
- [ ] content 含四节模板且使用场景/期望能力非空?
|
|
144
|
-
- [ ] 声音来源=真实会话平台(非硬编码)?
|
|
145
|
-
- [ ] 分类(若有)是三分类枚举值?
|
|
146
|
-
- [ ] 未把 agent 自己的评价混进用户原话?
|
|
113
|
+
- content=用户原话即可提交,**无模板、无必填推断节**(囤积端点无模板校验;
|
|
114
|
+
旧模板的"空=拒提交"作废)
|
|
115
|
+
- 分类可选:用户表述明显时填三分类 tags,判断不了不填(n01 引擎重判兜底)
|
|
116
|
+
- 渠道/来源一律不提交、不向用户提及(引擎按链路固定赋值)
|
|
117
|
+
- 提单/工单类诉求:不需要"复现步骤/严重程度/优先级"等开发者工单字段——
|
|
118
|
+
用户原话即完整提交物,缺什么由运营侧补充
|
package/vod_mcp/__init__.py
CHANGED