指南
排错指南
当某个功能看起来坏了，就按这页去定位问题是在发现、激活、输入、输出还是导航。
MCP 问题
1
工具没被选中
把工具名称和描述写得更具体，别太空泛。
2
输入不对
在执行前先检查 schema，拦住缺字段或格式错误的输入。
3
输出不对
如果模型还要继续推理，就返回结构化结果，不要只给一段散文。
Skill 问题
1
不激活
把描述改成更贴近用户动词和任务形状的说法。
2
太容易激活
加清楚的“不适用”边界，把范围收紧。
3
输出太虚
补模板、补示例、补断言，让格式更确定。
站点问题
语言会重置要保证语言选择能跨页面和刷新保留。
高亮错位要按真实路由判断 active，而不是按粗糙的章节名匹配。
搜索没结果要从真实内容路径里搜，而不是只写几个静态词。
按钮没反应只要界面露出来了，就必须真的能跳转、打开面板或说明用途。