问题报告：安装/更新 TraeWork CN 后 TraeCode 内置 Skill 丢失
1. 问题摘要
| 字段 | 内容 |
|---|---|
| 严重程度 | P1 — 核心功能缺失 |
| 影响范围 | TraeCode CN 用户安装/更新 TraeWork CN 后必现 |
| 可复现性 | 100% 可复现 |
| 版本 | TraeWork CN 最新版 |
| 操作系统 | macOS |
2. 问题描述
用户在安装或更新 TraeWork CN 后，TraeCode IDE 自带的内置 skill 被清除。受影响的 skill 为 TraeCode 的核心功能组件，用户在 TraeCode IDE 中将无法使用代码审查、调试器等功能。
3. 受影响的 Skill 清单
根据官方文档 (https://docs.trae.cn/ide_skills.md)，TraeCode 内置 4 个 skill：
| Skill | 状态 | 影响 |
|---|---|---|
TRAE-code-review |
 丢失 |
代码审查功能不可用 |
TRAE-debugger |
丢失 |
运行时调试功能不可用 |
TRAE-generate-mini-app |
丢失 |
小程序代码生成不可用 |
TRAE-security-review |
 保留 |
代码安全扫描仍可用 |
4. 证据
4.1 Manifest 文件对比
当前 solo.json (code agent_type) 中注册的 skill：
code/default: TRAE-product-knowledge, feedback
code/hebe: TRAE-computer-use-ptc, TRAE-product-knowledge, feedback
→ TRAE-code-review、TRAE-debugger、TRAE-generate-mini-app 均未在 manifest 中注册
当前 global.json 中注册的 skill：
TRAE-browseruse, TRAE-browseruse-external, TRAE-code-mode-orchestrator,
TRAE-computer-use, TRAE-computer-use-ptc, digital-avatar-creator,
dynamic-ui, skill-creator
→ 同样不包含丢失的 skill
4.2 磁盘文件验证
~/.trae-cn/builtin/code/default/skills/ ← 仅 TRAE-product-knowledge, feedback
~/.trae-cn/builtin/code/hebe/skills/ ← 仅 TRAE-computer-use-ptc, TRAE-product-knowledge, feedback
~/.trae-cn/builtin/global/skills/ ← 8 个 global skill，无丢失项
~/.trae-cn/builtin_skills/ ← 仅 TRAE-dynamic-ui, TRAE-security-review
→ 磁盘上不存在 TRAE-code-review、TRAE-debugger、TRAE-generate-mini-app 的 SKILL.md
4.3 skill-config.json 状态残留
{
"builtinSkillStatus": {
"TRAE-code-review": true,
"TRAE-debugger": true,
"TRAE-dynamic-ui": false
},
"deletedSkills": []
}
→ 配置文件中残留了启用状态标记，但对应的 skill 包文件已不存在
4.4 版本信息
| 文件 | 版本 | 日期 |
|---|---|---|
builtin/version.json |
1.0.23 | 2026-05-14 |
builtin/ide_version.json |
1.0.33 | 2026-07-15 |
builtin/manifests/*.json |
20260804193229 | 2026-08-04 |
→ Manifest 版本为 08-04（TraeWork 更新时间），覆盖了 07-15 的 IDE 版本
5. 根因分析
TraeWork 和 TraeCode 共享 ~/.trae-cn/builtin/ 目录，但各自的 manifest 定义了不同的 skill 集合。当 TraeWork 安装/更新时：
- 重新下载并写入
manifests/solo.json、manifests/global.json - 根据新 manifest 下载对应 skill 包到
builtin/子目录 - 不会保留旧 manifest 中存在但新 manifest 中不存在的 skill 包
TraeWork 的 manifest 中不包含 TRAE-code-review、TRAE-debugger、TRAE-generate-mini-app，因此这些 skill 被清除。
6. 预期行为
TraeWork 和 TraeCode 作为独立产品，应各自管理自身的 skill 集合，不应互相覆盖。可行的方案：
| 方案 | 说明 |
|---|---|
| A. Skill 合并 | 安装时合并两个产品的 manifest，取并集而非覆盖 |
| B. 命名空间隔离 | TraeWork skill 与 TraeCode skill 使用不同子目录 |
| C. 版本协商 | 检测到 skill 丢失时，从对应产品的仓库补全 |
7. 临时解决方案
- 重新安装 TraeCode IDE — 让 IDE 重新下发缺失的 skill
- 手动创建 skill — 通过"设置 > 技能与命令 > 创建"手动补充所需 skill
- 阻止覆盖 — 在 TraeWork 安装时备份
builtin/目录，安装后恢复 TraeCode 专属 skill
8. 附加信息
- 操作系统：macOS (Apple Silicon)
- 问题关联：TraeWork CN 安装/更新流程
- 建议优先级：高 — 影响 TraeCode 核心开发体验