joywayerandClaude Opus 5
0ba37c7212
原文档写着"164 个工具"并复述了一份按前缀分的工具清单, 对应的是已删除的旧扩展, 照着写会调不到工具。 改为不再复述工具用法: cocos-mcp-server 连上后会自注入 5.5K 字符的完整说明 (CRITICAL RULES + intent→tool 速查表 + 批量操作), 16 个工具的 description 也 各带 action 枚举与示例, 仓库里再维护一份副本必然随扩展版本腐化。 文档只保留 MCP 给不了的部分——服务离线时它的自带说明也一并消失, 而那正是最需要 "去编辑器点 Start Server"和"不要转而手改序列化文件"的时刻: - 前置条件、curl /health 探活、连不上时的排查顺序 - settings/mcp-server.json 的 autoStart:false, ECONNREFUSED 的常见成因 - 已知坑: cocos_asset.search 的 type 过滤失效; cocos_scene.hierarchy 的 includeComponents 失效; 编辑器里的 scene-2d 是 Creator 内置模板而非工程资产 (assets/ 下 0 个 .scene), 不必去仓库里找 技能里原本重复的"禁止手改 .scene/.prefab"规则改为引用 CLAUDE.md 单一来源, 依据 是仓库第二准则; 基线测试也表明未读该技能的 agent 仅凭 CLAUDE.md 即拒绝手改。 CLAUDE.md 里"动手前先读技能"改为条件式(正常操作不必读, 故障时才读), 此前该指令 与技能的排障定位冲突, 实测中不同 agent 对它的解读并不一致。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>