常见问题¶
客户端里看不到这个技能¶
确认技能目录正确、包内容完整（是整个技能目录，不是其中一层子目录），然后重开会话或重启客户端。
首次对话时提示正在检查更新¶
这是每次新任务的固定预检。看到「已更新」后会重新加载技能说明；看到「跳过」则继续沿用当前版本。
提示等待令牌 / TOKEN_REQUIRED¶
当前任务是 fork 或发布，但本机没读到个人令牌。按提示在本机配置好 Gitee 个人访问令牌后即可继续；令牌就绪前不会访问 Git 或远端。
构建被标记为未执行（NOT_RUN）¶
当前环境无法完成依赖安装或构建。构建是 Basic 审查的必需项，因此不会进入发布：项目会保留，请按提示在本机补齐安装或构建后重新审查。
提示发现同名扩展，或目录名被加了后缀¶
查重（Lite）在官方清单或 Gitee 中找到了相同 id 的库。只有 id 相同、作者不同时，新目录会追加作者后缀避免冲突，config.id 不变；author 与 id 都相同时则沿用已存在的库，非你本人的仓库会先 fork。详见代码审核。
打包出来的 ZIP 超过 5MB¶
Basic 审查要求最终扩展 ZIP 不超过 5,000,000 字节。超限时项目保留但不发布，通常是图标、封面图或内置资源偏大，精简后重新打包即可。
AI 停下来问我问题¶
通常是缺少产品决策类信息，例如积木行为、扩展的 id / author、支持的主板或目标仓库。这类问题需要你来定，skill 不会自行猜测。