---
last_reviewed: 2026-10-19
---

# scripts — 自检脚本与数据目录

| 文件/目录 | 说明 |
|-----------|------|
| `gen_mcp_docs.py` | 从运行时 schema 重新生成 `docs/MCP.md` 的工具参考一节（`make mcp-docs`；`make docs-check`
  只比对，漂移退出码 1）。加了工具却没在 GROUPS 登记会直接报错——刻意闸门 |
| `install_skill.py` | 把报销技能同步到用户级技能目录，让它脱离本仓库可用（`make skill-install` /
  `make skill-check`）。装之前会核实该目录作为技能来源是否启用：装进停用的来源里，宿主永远扫不到 |
| `mcp_smoke.py` | MCP stdio 自检：拉起自身、打印工具清单、验证 instructions 已下发、调一次 `case_list`。
  `make mcp-smoke` 或 `python tasks.py mcp-smoke` |
| `data/` | 项目级配置目录（见 `data/README.md`） |

三个脚本都不改业务代码：`mcp-smoke` 验线上契约，`mcp-docs` 由线上 schema 出文档，`install_skill` 只管拷贝。
改完工具的顺序是 `mcp-smoke` → `mcp-docs`。

改完 MCP 工具一定要跑 `mcp_smoke`：它验的是**线上传输**的契约，进程内 import 成功不代表宿主能看到工具。