QCM · Quality Crisis Management

QCM · Quality Crisis Management

质量问题解决指导 Skill。v1.0.0 发布版 · 把「质量危机处置 + 体系治理评估 + 知识沉淀」封装成可复用的问题解决流水线。

5 秒看懂

# MCP server（10 工具：问题解决核心 6 + Infoseek 协同 3 + 插件 1）
python scripts/mcp_server.py

输入场景 → 协议匹配（action-orders 14 章）→ 场景路由（意图×领域）→ 4 形态输出
案例应用 / 决策卡片 / 评估报告 / 快速响应（防御性标注 + 缺口协同）

🎉 v1.0.0 发布亮点

快速上手

1. 安装 / 升级

pip install -r requirements.txt          # 核心依赖（PyYAML）
pip install -r requirements-optional.txt # 可选能力（LLM / GraphQL / OTel 等）
# 完整依赖说明见 DEPENDENCIES.md

2. MCP 集成

项目提供 .mcp.json（双服务器配置，可直接被 Claude/Codex 等客户端加载）：

{
  "mcpServers": {
    "qcm-search": {
      "command": "${QCM_ROOT}/scripts/mcp_server.py",
      "args": ["--transport", "stdio"],
      "env": {
        "QCM_ROOT": "${QCM_ROOT}",
        "QCM_AUTH_TOKEN": "${QCM_AUTH_TOKEN}"
      }
    },
    "infoseek-search": {
      "command": "${INFOSEEK_ROOT}/scripts/infoseek_mcp_server.py",
      "args": ["--transport", "stdio"],
      "env": {
        "INFOSEEK_ROOT": "${INFOSEEK_ROOT}"
      }
    }
  }
}

💡 Windows 环境请将 command 改为 python3 + args: ["脚本路径", "--transport", "stdio"]。

工具列表（10 个）：

• 问题解决核心 6 个：qcm_research / qcm_decide / qcm_solve_problem / qcm_score_source / qcm_audit / qcm_validate
• Infoseek 协同 3 个：qcm_attribution / qcm_attribution_phase / qcm_gap_detect
• 插件扩展 1 个：qcm_plugin_echo（热加载样例）

3. 环境变量

文档导航

版本路线

测试矩阵

⚠️ 用例数为各套件自报（PASS 计数）。运行入口：python tests/run_all.py（脚本风格，勿用 pytest）。

环境差异说明：v021（需 LLM Key）与 v071（Infoseek ws 已移除）在缺失环境自动 SKIP，不误报 FAIL；v131/v151 需 OTel 依赖（env_restore.sh --deps 一键恢复）。

项目结构

QCM/
├── SKILL.md               # Skill 定义（yfm + 文档）
├── manifest.yaml          # 平台 manifest
├── skill_meta.json        # 元数据（版本/范式/维度/输出形态）
├── README.md              # 本文件
├── version_history.md     # 版本历史
├── DEPENDENCIES.md        # 依赖声明
├── API_KEYS.md            # Key 声明（不含真实值）
├── core/                  # 核心库（路由/组装/验证/组件扫描/缺口检测）
│   ├── router.py          # 场景路由（意图×领域 → 形态×组件）
│   ├── assembler.py       # 输出组装（母模板锚点提取）
│   ├── validator.py       # 4 形态验证器（96/96）
│   ├── component_scan.py  # 组件热度分级
│   └── gap_detector.py    # 5 维缺口检测
├── scripts/               # 适配层 + MCP server + 工具模块
│   ├── mcp_server.py      # MCP server 门面（10 工具）
│   ├── infoseek_bridge.py # QCM↔Infoseek 归因桥（L0→L3 降级）
│   ├── sync_manifest.py   # 双绑校验
│   ├── config_sync.py     # 守卫 9 检
│   └── ...
├── references/            # 协议 + 契约 + 词库 + 配置 + 索引
│   ├── protocol/action-orders.md  # 14 章协议权威
│   ├── contract/          # mds-input + 输入指引
│   ├── config/            # keyword/entities/components/constraint 等 10 配置
│   └── index/             # cases/knowledge-base/masters/tools 索引
├── components/            # 组件池（28 组件，索引自动生成勿手改）
├── outputs/               # 4 形态模板（唯一真源）
├── plugins/               # 插件扩展（热加载）
├── deploy/                # 部署资产（docker/k8s/monitoring/api）
├── docs/                  # CHANGELOG / INSTALL / TROUBLESHOOTING / eval
└── tests/                 # 38 套件（basic/protocol/engines + 主测试）

贡献与反馈

• Bug 报告：附 qcm --version（或 server 启动日志）+ 最小复现
• 协议问题：附涉及的 action-orders 章节号
• 功能请求：附用例 + 期望输出形态
• 测试失败：运行 python tests/run_all.py 附完整输出

v1.0.0 | 4 层级架构 · 14 章协议 · 4 形态 · 场景路由消费 · 组件池三机制 | 全行业质量危机管理 | Apache-2.0 License