defect-to-testcase 知识库使用说明

缺陷文本 → 标准测试用例（text-to-testcase 规则 + QMD 本地知识库 grounding）。不限被测对象，知识域由调用方通过 --domain 显式提供。

1. 知识库路径

• 本地知识库目录：knowledge-base/（项目根下）。往这里放 .md 文件即知识库内容。
• 注册表 knowledge/knowledge-sources.yaml 里 sample-business 域（示例业务域）的 sample-business-qmd 源已指向该目录：

providers:
  qmd-local:
    type: qmd
    command: qmd
    index: defect-case-knowledge      # QMD 具名索引
    enabled: true
languages:
  sample-business:
    kind: business                     # 业务域（不分 stage，任何阶段都查）
    sources:
      - id: sample-business-qmd
        provider: qmd-local
        path: xxx   # 知识库路径
        collection: sample-business    # QMD collection 名
        mask: '**/*.md'
        search_mode: search           # BM25
        enabled: true

sample-business 仅为示例业务域名，请按你的被测对象替换为真实业务域（如 myapp-live），并相应调整 collection 与 index。

2. QMD 安装

npm i -g @tobilu/[email protected]

验证：

qmd --version      # 期望: qmd 2.5.3
qmd status         # 期望: 正常输出索引状态、不崩溃

3. 知识库更新方法

往 知识库路径 加/改 .md 后，重索引即可：

qmd --index defect-case-knowledge update

或经 skill 同步：

python defect-to-testcase/code-knowledge-query/scripts/knowledge_source.py sync --source-id sample-business-qmd

首次建索引（仅供还原参考，当前已建好）：

qmd --index defect-case-knowledge collection add "xxx" --name sample-business --mask "**/*.md"
qmd --index defect-case-knowledge context add "qmd://sample-business" "business knowledge domain: sample-business"
qmd --index defect-case-knowledge update

4. 检索（query）

python defect-to-testcase/code-knowledge-query/scripts/knowledge_source.py query \
  --source-id sample-business-qmd \
  --question '<决策级问题>' \
  --keyword '<精确术语>'

• BM25 默认、无需模型 key。中文术语务必作为可重复 --keyword 传入（自然语言句子 tokenize 不好时靠 keyword 兜底）。
• 返回 status: answered + citations（.md 路径），回填到用例「知识：」区。

环境

• Python 依赖：首次跑 python defect-to-testcase/code-knowledge-query/scripts/init_knowledge.py --skip-deepwiki-check 建 venv + 装 PyYAML。