# gstack-trae

**Repository Path**: cambright/gstack-trae

## Basic Information

- **Project Name**: gstack-trae
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gstack — Trae 适配版

源自 [garrytan/gstack](https://github.com/garrytan/gstack.git)。

**上游 commit id**: `25cf5edf210fee2cd296ffb2dfb2eff370ebcf35`

## 兼容的技能（共 47 个）

| 技能名称 | 说明 |
|----------|------|
| gstack (主技能) | 无头浏览器 QA 测试和站点 dogfooding |
| autoplan | 自动化计划审查 |
| benchmark | 基准测试 |
| benchmark-models | 模型基准测试 |
| browse | 浏览器技能 |
| canary | 部署后监控 |
| careful | 谨慎检查 |
| context-restore | 上下文恢复 |
| context-save | 上下文保存 |
| cso | CSO 审查 |
| design-consultation | 设计咨询 |
| design-html | HTML 设计 |
| design-review | 设计审查 |
| design-shotgun | 散弹式设计 |
| devex-review | 开发者体验审查 |
| document-generate | 文档生成 |
| document-release | 文档发布 |
| freeze | 冻结检查 |
| gstack-upgrade | gstack 升级 |
| guard | 守卫检查 |
| health | 健康检查 |
| investigate | 调查 |
| hackernews-frontpage (browser-skill) | Hacker News 前端浏览器领域技能 |
| land-and-deploy | 着陆部署 |
| landing-report | 着陆报告 |
| learn | 学习 |
| make-pdf | PDF 生成 |
| office-hours | 办公时间 |
| open-gstack-browser | 打开 gstack 浏览器 |
| pair-agent | 配对代理 |
| plan-ceo-review | CEO 计划审查 |
| plan-design-review | 设计计划审查 |
| plan-devex-review | 开发者体验计划审查 |
| plan-eng-review | 工程计划审查 |
| plan-tune | 计划调优 |
| qa | QA 测试 |
| qa-only | 仅 QA |
| retro | 回顾 |
| review | 代码审查 |
| scrape | 抓取 |
| setup-browser-cookies | 浏览器 Cookie 设置 |
| setup-deploy | 部署设置 |
| setup-gbrain | gbrain 设置 |
| ship | 发布 |
| skillify | 技能化 |
| sync-gbrain | gbrain 同步 |
| unfreeze | 解冻 |

## 兼容修改

### 路径适配
- `~/.claude/skills/gstack` → `~/.trae-cn/skills/gstack`（Trae 全局技能目录）
- `~/.claude` → `~/.trae-cn`（Trae 全局配置目录）
- `.claude/skills/gstack` → `.trae/skills/gstack`（工作区技能目录）
- `.claude/` → `.trae/`（工作区配置目录）
- `~/.claude.json` → `~/.trae-cn.json`（Trae 全局配置文件，含注释更新）
- `$HOME/.claude/plans` → 已移除（仅保留 `$HOME/.trae-cn/plans`）
- `$HOME/.codex/plans` → 已移除（非 Trae 代理路径）
- `browse/src/server.ts` 中的默认技能根路径已适配
- `hosts/claude.ts` 中 `hostSubdir` 改为 `.trae`，`displayName` 改为 `Trae`，`coAuthorTrailer` 改为 Trae AI
- `bin/gstack-paths` 中的路径解析已适配
- `setup` 脚本中的技能注册路径已适配，competitor 安装段（Codex/Kiro/Factory/OpenCode/.agents/）已彻底移除，仅保留 Trae 安装路径
- `gstack-upgrade/migrations/` 中的路径引用已适配
- `extension/` 中的 UI 文本已适配
- `scripts/resolvers/review.ts`、`scripts/resolvers/design.ts` 和 `scripts/resolvers/preamble/generate-brain-sync-block.ts` 中的路径引用已适配

### 平台适配
- 为所有包含 bash 代码的 SKILL.md 和 SKILL.md.tmpl 添加了 PowerShell 平台说明
- 说明 bash 代码块在 PowerShell 中的处理方式（使用 WSL2/Git Bash）
- 替换 `&&` 为 `;` 分号（PowerShell 语法）
- 替换 `2>/dev/null` 为 `2>$null`（PowerShell 语法）
- 设置 `GSTACK_CLAUDE_BIN=wsl` → 改为通用说明「gstack `bin/` utilities require Bash (WSL2 or Git Bash on Windows)」

### 环境适配
- 所有 "Claude Code" 文本替换为 "Trae"（SKILL.md、SKILL.md.tmpl、源码、扩展等）
- "Anthropic's Claude" 品牌引用替换为 "Trae"（benchmark-models 等）
- "Claude subagent" / "Claude adversarial subagent" 等子代理引用替换为 "agent subagent" / "adversarial agent subagent"（plan-*review、autoplan、review、ship 等）
- "Codex or Claude subagent" 引用替换为 "second opinion agent"（office-hours）
- 跨模型 Codex 审查路径简化为单代理模式（plan-*review、autoplan）
- 移除 pair-agent 中的 Codex/Cursor/Hermes 代理选项，仅保留 Trae 和 OpenClaw
- 移除 retro 技能中的 Codex/Gemini 会话统计，仅保留 Trae 统计
- 移除 setup-gbrain 中的 "(Cursor, Codex CLI, etc.)" 引用
- 设计文档中 Cursor/Windsurf/Copilot/Kiro 等竞争 AI 工具引用已移除或替换为 Trae
- benchmark-models 技能从跨模型对比（Claude/GPT/Gemini）改为 Trae 性能基准测试，移除硬编码模型提供商引用，简化触发词和标签
- setup 脚本中用户提示信息 "gstack ready (claude)" 更新为 "gstack ready (trae)"
- `design-html` 和 `design` resolver 中 "GPT-4o vision" 和 OpenAI 文章引用已替换为通用技术表述
- `mcp__claude-in-chrome__*` MCP 工具引用替换为通用浏览器 MCP 工具说明
- `setup-gbrain` 技能中 `claude mcp add/remove/list` 命令替换为直接写入 `~/.trae-cn.json` 的 `jq` 操作（使用 `{"mcpServers": {...}}` 格式）
- 所有 `~/.claude.json` / `~/.trae-cn/mcp.json` 引用统一为 `~/.trae-cn.json`
- MCP 注册说明添加了 PowerShell 等效命令
- `claude.json` 引用替换为 `$HOME/.trae-cn.json`（含代码和注释，包括 bash 注释中的文件名引用）
- `/retro` 技能中 JSON 示例数据 `"claude_code"` 会话键名改为 `"trae"`，`"CC:"` 标签改为 `"Trae:"`
- `subprocess to claude CLI` 注释替换为 `subprocess to Trae CLI`
- `package.json` 描述已适配
- Chrome 扩展 UI 文本已适配（sidepanel、terminal、background）
- `CLAUDE.md` 和 `CLAUDE.local.md` 保留（Trae 支持）
- `AGENTS.md` 中 `/benchmark-models` 技能描述已适配（跨模型对比 → Trae 性能基准），claude CLI 二进制引用已通用化
- `CLAUDE.md` 中侧栏终端 "claude PTY" → "agent PTY"、"Claude Haiku" → "Haiku"、"tells Claude" → "tells the agent" 等引用已适配
- `hosts/index.ts` 中 `getExternalHosts()` 注释 "primary host (Claude)" → "primary host (Trae)"
- 所有 SKILL.md 文件中 `Model-Specific Behavioral Patch (claude)` 标题已去模型族名（→ `Model-Specific Behavioral Patch`），"tuned for the claude model family" → "tuned for the agent model family"
- `scripts/resolvers/model-overlay.ts` 生成器已同步适配上述标题和文案（未来重新生成时无需重复修改）
- `ETHOS.md` 中 "interrupt Claude" → "interrupt AI agents"
- `AGENTS.md` 保留（Trae 支持）
- `skills/AGENTS.md` 移除 `/codex` 技能引用行（Trae 运行时不需要，根目录 `AGENTS.md` 保留作为开发者参考）
- `CLAUDE_PLUGIN_DATA` / `CLAUDE_PLANS_DIR` 替换为 `GSTACK_HOME`（Trae 无此 Claude Code 特有环境变量）
- `freeze/bin/check-freeze.sh` 路径解析适配
- `browse/src/terminal-agent.ts` 安装文档 URL 适配
- `USING_GBRAIN_WITH_GSTACK.md` 中 "Claude-Code-targeted" 改为 "Trae-targeted"
- `skills/hosts/codex.ts` 已删除，`skills/hosts/index.ts` 已移除 codex 导入/导出（Trae 专用运行时环境）
- `skills/package.json` 已移除 codex/gemini 测试脚本（`test:codex`、`test:gemini` 等）
- `skills/CLAUDE.md` 已清理 Codex 引用（Codex E2E 测试说明、Codex 目录引用、codex findings 等），"CC+gstack" 替换为 "Trae+gstack"
- `skills/browse/src/terminal-agent.ts` 注释中 "codex's outside-voice review" → "outside-voice review"，"Codex finding #4" 移除
- `browse/src/welcome.html` 中 "Claude instance" → "agent instance"（用户界面文本）
- `browse/src/browser-manager.ts` 中 "Claude takes" → "the agent takes"（代码注释）
- `browse/src/security.ts` 中 "Claude is told" → "The agent is told"（代码注释）
- `bin/gstack-uninstall` 中变量名 `CLAUDE_SKILLS` → `SKILLS_DIR`，移除 `REMOVED` 输出中的 "claude/" 前缀
- `bin/dev-teardown` 中变量名 `CLAUDE_SKILLS` → `SKILLS_DIR`，移除输出中的 "claude/" 前缀
- `bin/gstack-memory-ingest.ts` 移除 `walkCodexSessions()` 函数和 Codex 会话扫描逻辑，`PageRecord.agent` 从 `"claude-code" | "codex" | "cursor"` 改为 `"trae" | "cursor"`，`ParsedSession.agent` 从 `"claude-code" | "codex"` 改为 `"trae"`，移除 Codex 检测和渲染代码，路径注释更新为 Trae
- `bin/gstack-global-discover.ts` 移除 `scanCodex()` 和 `scanGemini()` 函数，`Session.tool` 从 `"claude" | "codex" | "gemini"` 改为 `"trae"`，`scanClaudeCode()` 重命名为 `scanTrae()`，输出标签 "CC:" → "Trae:"
- `setup-gbrain/memory.md` 移除 Codex CLI 和 Cursor 会话类型的表格行
- `skills/browse/bin/find-browse` 搜索标记增加 `.trae`（`for MARKER in .trae .codex .agents .claude; do`）
- `cso/ACKNOWLEDGEMENTS.md`（根目录 + skills/）恢复原始引用（"Claude Code Security Pack"、"Anthropic Claude Code Security"），之前的 "Trae Security Pack" 错误修正确认纠正
- 根目录 `hosts/index.ts` 中残留的 `import codex from './codex'` 已移除，`hosts/codex.ts` 已删除（与 `skills/` 版本同步一致）
- `setup-gbrain/memory.md` 中示例路径 `transcripts/claude-code/` → `transcripts/trae/`
- `browse/src/claude-bin.ts` 完整重写：环境变量 `GSTACK_CLAUDE_BIN`/`CLAUDE_BIN` → `GSTACK_TRAE_BIN`/`TRAE_BIN`，函数 `resolveClaudeCommand()`/`resolveClaudeBinary()` → `resolveTraeCommand()`/`resolveTraeBinary()`，接口 `ClaudeCommand` → `TraeCommand`，二进制 `Bun.which('claude')` → `Bun.which('trae')`
- `browse/src/security-classifier.ts` 适配：导入改为 `resolveTraeCommand`，变量名 `claude` → `trae`，错误原因 `claude_cli_not_found` → `trae_cli_not_found`，所有 CLI 调用注释更新（Haiku 模型名称保留，属于 Anthropic 模型 API 而非 Claude Code 代理）
- `browse/src/security.ts` 注释引用更新：`resolveClaudeCommand` → `resolveTraeCommand`
- `scripts/preflight-agent-sdk.ts` 适配：导入 `resolveTraeBinary`，变量 `claudePath` → `traePath`，错误消息和环境变量引用已更新
- `AGENTS.md` 和 `skills/AGENTS.md` 中 `GSTACK_CLAUDE_BIN` → `GSTACK_TRAE_BIN`
- `browse/src/terminal-agent.ts` 完整 Trae 迁移：`findClaude()` → `findTrae()`，`spawnClaude()` → `spawnTrae()`，`writeClaudeAvailable()` → `writeTraeAvailable()`，HTTP 端点 `/claude-available` → `/trae-available`，错误码 `CLAUDE_NOT_FOUND` → `TRAE_NOT_FOUND`，所有注释和状态文件名中的 "claude" → "trae"
- `extension/sidepanel-terminal.js` 状态机重构：`STATE.NO_CLAUDE` → `STATE.NO_TRAE`，`checkClaudeAvailable()` → `checkTraeAvailable()`，变量 `claudeStatus` → `traeStatus`，所有注释更新
- `extension/sidepanel.js` 注释适配：各 "claude PTY" 引用 → "trae PTY"
- `extension/background.js` 注释适配：各 "claude" 引用 → "trae"
- `bin/gstack-gbrain-detect` MCP 检测简化：移除 `claude mcp get/list` CLI 命令（Trae 不支持），直接读取 `~/.trae-cn.json` 配置文件，`CLAUDE_JSON` 变量 → `TRAE_JSON`
- `bin/gstack-memory-ingest.ts` 函数重命名：`walkClaudeCodeProjects()` → `walkTraeProjects()`，NUL 字节注释中的 "Claude Code" → "agent session"
- `browse/test/claude-bin.test.ts` 测试完全重写：测试组名 `claude-bin` → `trae-bin`，所有环境变量和函数引用更新（`GSTACK_TRAE_BIN`、`resolveTraeCommand`、`resolveTraeBinary`），假二进制名 `fake-claude-cli` → `fake-trae-cli`
- `browse/test/security-classifier-tdz.test.ts` 测试适配：环境变量 `GSTACK_CLAUDE_BIN`/`CLAUDE_BIN` → `GSTACK_TRAE_BIN`/`TRAE_BIN`，函数引用 `resolveClaudeCommand` → `resolveTraeCommand`，测试组名和注释更新，断言正则适配 `trae_cli_not_found`
- `test/gstack-paths.test.ts` 测试适配：移除原 CLAUDE_PLUGIN_DATA/CLAUDE_PLANS_DIR 回退链测试，添加验证这些变量在 Trae 适配中无效的测试，PLAN_ROOT 预期路径从 `.claude/plans` → `.trae-cn/plans`
- `test/hook-scripts.test.ts` 测试适配：所有 `CLAUDE_PLUGIN_DATA` 环境变量 → `GSTACK_HOME`，与适配后的 freeze/careful 脚本一致
- `test/helpers/providers/claude.ts`：替换对 `claude-bin.ts`（已完全适配为 Trae 解析器）的损坏导入，改为内置 Claude CLI 解析函数（`Bun.which('claude')` + 环境变量覆盖），与 Trae 适配后的 `claude-bin.ts` 导出不再冲突
- `test/helpers/agent-sdk-runner.ts`：替换对 `claude-bin.ts` 的损坏导入，改为内置 Claude CLI 解析函数，`resolveClaudeBinary()` 函数体从单行委托改为自包含实现
- 所有 SKILL.md 文件：`echo "MODEL_OVERLAY: claude"` → `echo "MODEL_OVERLAY: trae"`
- `model-overlays/trae.md` 创建（根目录 + skills/）：复制自 `claude.md`，与 `MODEL_OVERLAY: trae` 对应，Trae 运行时加载模型行为覆盖层
- `setup-gbrain/SKILL.md`（及 `skills/setup-gbrain/SKILL.md`）：诊断状态 `claude-missing` → `trae-missing`
- `skills/bin/gstack-codex-probe` 已删除（Codex 专用探针，Trae 运行时不需要，同步根版本已删除）
- 完全移除 `codex/` 和 `openclaw/` 目录（含所有 SKILL.md、SKILL.md.tmpl、openclaw/skills/ 子目录及 gstack-openclaw-* 技能文件）
- 删除 6 个非 Trae 宿主配置文件：`hosts/codex.ts`、`hosts/cursor.ts`、`hosts/hermes.ts`、`hosts/kiro.ts`、`hosts/opencode.ts`、`hosts/slate.ts`、`hosts/openclaw.ts`
- 删除 5 个 Codex/Gemini/OpenClaw 测试文件：`test/codex-hardening.test.ts`、`test/codex-e2e.test.ts`、`test/codex-e2e-plan-format.test.ts`、`test/codex-resume-flag-semantics.test.ts`、`test/openclaw-native-skills.test.ts`
- 删除 2 个非 Trae 测试辅助文件：`test/helpers/codex-session-runner.ts`、`test/helpers/gemini-session-runner.ts`
- 删除 Codex/Gemini golden fixture：`test/fixtures/golden/codex-ship-SKILL.md`
- 删除非 Trae 文档文件：`docs/OPENCLAW.md`、`docs/designs/SLATE_HOST.md`、`bin/gstack-codex-probe`、`scripts/host-adapters/openclaw-adapter.ts`、`agents/openai.yaml`
- `hosts/index.ts` 注册表精简：从 10 个宿主减少为 3 个（claude/Trae、factory、gbrain），移除所有非 Trae 宿主导入和导出
- `scripts/resolvers/preamble/generate-brain-health-instruction.ts`：移除 hermes 宿主检查（仅保留 gbrain）
- `scripts/resolvers/preamble/generate-preamble-bash.ts`：移除 hermes 宿主条件
- `scripts/resolvers/preamble/generate-brain-sync-block.ts`：移除 hermes 宿主检查
- `scripts/gen-skill-docs.ts`：移除 OpenClaw 文件生成代码块、移除 codex-helpers 死代码导入；默认模型参数 `return 'claude'` → `return 'trae'`
- `bin/gstack-memory-ingest.ts`：注释 "Cursor SQLite extraction" → "Agent SQLite extraction"
- `bin/gstack-uninstall`、`bin/dev-setup`：注释中 "Codex/Gemini/Cursor" → 移除代理名称引用
- `test/host-config.test.ts`：所有 codex/opencode 引用替换为 gbrain，移除 opencode symlinks 测试，移除 Codex golden 测试
- `test/skill-collision-sentinel.test.ts`：注释中移除 codex/kiro/opencode/slate/cursor/openclaw/hermes 代理列表
- `test/gen-skill-docs.test.ts`：移除约 858 行 Codex 相关测试代码（CODEX_SECOND_OPINION、Codex filesystem boundary、DESIGN_REVIEW_LITE Codex、Codex generation、setup script Codex 安装测试等）
- `CLAUDE.md`：移除项目结构中非 Trae 宿主列表（codex, kiro, opencode, slate, cursor, openclaw, hermes），移除 OpenClaw ClawHub 发布章节，移除 Codex E2E 测试说明，"CC+gstack" → "Trae+gstack"
- `browse/src/server.ts`：注释中 codex 引用已移除或通用化
- `scripts/resolvers/preamble/generate-preamble-bash.ts`：`OPENCLAW_SESSION` 环境变量 → `ORCHESTRATOR_SPAWNED_SESSION`（消除 OpenClaw 专用环境变量名）
- `scripts/resolvers/preamble/generate-spawned-session-check.ts`：移除 "e.g., OpenClaw" 引用，改为通用 "AI orchestrator"
- `scripts/host-config.ts`：注释示例从非 Trae 代理（Codex, OpenCode, OpenClaw）全部替换为 Trae/Factory/GBrain 示例
- `scripts/gen-skill-docs.ts`：移除 OpenClaw 文件生成代码块（~60 行：gstack-lite/gstack-full/gstack-plan 生成逻辑），之前仅移除 codex-helpers 死代码导入
- `setup`（根目录 + skills/）：移除 openclaw 和 hermes 宿主分支（case 语句 ~30 行），host 参数值从 "claude, openclaw, hermes, gbrain, or auto" 改为 "claude, gbrain, or auto"
- `bin/gstack-brain-consumer`（根目录 + skills/）：注释移除 "Codex, OpenClaw" 代理名称
- `setup-gbrain/SKILL.md.tmpl`：2 处 "openclaw/hermes agents" → "cloud-hosted agents"，消除非 Trae 代理名称
- `pair-agent/SKILL.md.tmpl`：3 处清理 —— 代理选项 "OpenClaw" → "Remote agent"，主机值 "openclaw" → "remote"，平台说明 "OpenClaw / AlphaClaw" → "Remote agents"

### 解析器适配（Resolver 代码清理）

解析器文件（`scripts/resolvers/`）在 `bun run gen:skill-docs` 构建时生成 SKILL.md 内容。移除了以下 Codex 执行逻辑，确保 Trae 运行时不会出现非 Trae 代理指令：

- **`scripts/resolvers/design.ts`**：
  - `generateDesignReviewLite()`：移除 ~25 行 `codexBlock` 模板字面量（Codex exec 命令），替换为空字符串
  - `generateDesignSketch()`：移除 ~30 行 `outsideVoicesBlock` 模板字面量（Codex 草图生成），替换为空字符串
  - `generateDesignOutsideVoices()`：从 ~180 行 Codex 并行审查块简化为 3 行空返回 stub
  - 移除所有 `ctx.host === 'codex'` 宿主检查
- **`scripts/resolvers/review.ts`**：
  - `generateCodexSecondOpinion()`：移除整个函数体 ~110 行 Codex 执行指令，替换为空返回
  - `generateCodexPlanReview()`：移除整个函数体 ~140 行，替换为空返回
  - `generateAdversarialStep()`：保留（使用 Trae Agent 原生子代理，非 Codex），仅移除 `ctx.host === 'codex'` 死代码检查
- **`scripts/resolvers/learnings.ts`**：移除 `ctx.host === 'codex'` 分支 ~14 行 Codex 特定学习搜索代码，简化 `binDir` 赋值
- **`scripts/resolvers/preamble.ts`**：T3 注释中移除 "codex" 引用
- **`scripts/resolvers/codex-helpers.ts`**：删除整个文件（133 行死代码，无任何文件导入）
- **`scripts/resolvers/constants.ts`**：函数 `codexErrorHandling()` 重命名为 `errorHandling()`，注释移除 Codex 引用
- **`scripts/resolvers/index.ts`**：RESOLVERS 映射表移除 `CODEX_SECOND_OPINION` 和 `CODEX_PLAN_REVIEW` 死条目

### 构建脚本与辅助文件清理

- **`scripts/gen-skill-docs.ts`**：移除 5 处 Codex 引用注释（"matches codex-helpers.ts"、Codex 1024-char 限制、openai.yaml 等）
- **`scripts/host-config.ts`**：注释中非 Trae 代理示例 `(Claude, Codex, Factory, OpenCode, OpenClaw, etc.)` → `(Claude, Factory, GBrain, etc.)`
- **`bin/gstack-memory-ingest.ts`**：3 处注释 `Codex finding` → `review finding`，1 处 `Codex outside-voice` → `outside-voice`
- **`bin/gstack-artifacts-init`**：2 处注释 `codex Finding #` → `Finding #`
- **`gstack-upgrade/migrations/v1.27.0.0.sh`**：2 处注释 `codex Finding #6` → `Finding #6`
- **`hosts/gbrain.ts`**：`suppressedResolvers` 数组移除 `CODEX_SECOND_OPINION` 和 `CODEX_PLAN_REVIEW`（引用的 resolver 已删除）
- **`gstack/llms.txt`**：移除 `/claude` 和 `/codex` 技能条目（技能已删除）
- **`lib/gbrain-local-status.ts`**：3 处注释 `codex #8` → `review #8`
- **`browse/src/browser-manager.ts`**：注释 `(Codex T7)` → `(T7)`
- **`browse/src/terminal-agent.ts`**：注释 `Codex finding #4` → `Finding #4`
- **`browse/src/security.ts`**：注释 `Codex tier-2 finding` → `tier-2 finding`
- **`review-diff.txt`**：重新生成（2.5MB），正确对比上游仓库与适配工作区的差异
- **状态文件重命名**：`bin/gstack-update-check` 中 `.codex-desc-healed` → `.desc-healed`，消除非 Trae 代理前缀

### 文件结构
- 移除了 `.git` 目录和上游仓库的 Git 信息
- 移除了 `.agents/` 目录（OpenAI/Codex 代理配置文件，非 Trae 平台）
- 保留了所有技能文件、bin 脚本、browse 服务器等完整功能
- `skills/` 目录包含全部 47 个技能（1 个主技能 + 45 个子技能 + 1 个浏览器领域技能）的 SKILL.md（不含 .tmpl 模板和 test 测试文件）
- `skills/` 目录已清理以下非运行时文件（仅保留 Trae 运行时所需）：
  - 文档类：ARCHITECTURE.md、BROWSER.md、CHANGELOG.md、CONTRIBUTING.md、DESIGN.md、ETHOS.md、TODOS.md、USING_GBRAIN_WITH_GSTACK.md
  - 配置类：slop-scan.config.json、bun.lock、conductor.json
  - 构建产物：`.github/`、`scripts/`、`test/`、`docs/`、`contrib/` 目录
  - 模板文件：所有 SKILL.md.tmpl（构建时使用，运行时不需要）
  - 非 Trae 宿主配置：`.cursor`、`.factory`、`.gbrain`、`.hermes`、`.kiro`、`.openclaw`、`.opencode`、`.slate` 等 dot 目录
  - 其他：`.gitattributes`、`.gitignore`、`.gitlab-ci.yml`、`.env.example`
- `skills/` 目录包含关键运行时依赖：
  - `bin/` — 所有 gstack 工具脚本（gstack-config, gstack-slug 等）
  - `lib/` — 共享库（gstack-memory-helpers, gbrain-local-status 等，bin/ 脚本运行时依赖）
  - `browse/` — 无头浏览器基础设施（含 src/，需 `bun` 编译二进制）
  - `extension/` — Chrome 扩展（open-gstack-browser 和 browse 运行时依赖）
  - `browser-skills/` — 浏览器领域技能（如 hackernews-frontpage）
  - `hosts/` — 宿主类型配置
  - `setup` — 安装脚本
  - `package.json` — 依赖管理
  - `VERSION` — 版本号文件
  - `SKILL.md` — gstack 主技能
  - `AGENTS.md` / `CLAUDE.md` — Trae 代理配置和约定
  - `LICENSE` / `VERSION` — 许可证和版本号
  - `connect-chrome` — open-gstack-browser 别名符号链接
  - `design/src/` — 设计工具 CLI 源码（含 generate、variants、compare 等命令）
  - `supabase/` — 遥测与社区功能后端服务（migrations + Edge Functions）
  - `make-pdf/src/` — PDF 生成工具 CLI 源码
  - `model-overlays/` — 模型行为覆盖层配置
  - `gstack/` — `llms.txt` 等技能列表文件

### 部署说明
- 将 `skills/` 目录复制到 Trae 全局技能目录 `~/.trae-cn/skills/gstack/`
- `bin/` 脚本为 Bash 脚本，在 Windows 上需要 WSL2 或 Git Bash 才能执行
- `$B` (browse 二进制) 需要先编译：
  ```bash
  cd ~/.trae-cn/skills/gstack/browse
  bun install
  bun run build
  ```

## 未兼容的内容

- **`claude/` 技能模板**：此技能是一个包装 `claude -p` CLI 的跨宿主桥梁，需要安装 Anthropic 官方 `claude` CLI 才能工作。Trae 环境中无此 CLI，`claude/SKILL.md.tmpl` 已从适配工作区完全删除
- **`codex/` 和 `openclaw/` 目录**：已完全从适配工作区中删除。`codex/` 包装 OpenAI Codex CLI 用于跨模型审查，`openclaw/` 提供 OpenClaw 原生技能及 ClawHub 发布管道。两者均为非 Trae 平台专用，所有其他技能中的相关引用已彻底清除
- **`contrib/add-host/`**：贡献者开发工具，用于添加新 AI 宿主配置。非用户技能，保留模板源文件但未适配
- **测试文件**（`test/`、`browse/test/`）中的 `~/.claude` 引用保持不变（测试针对原始环境编写，不在 Trae 中运行）
- **CHANGELOG.md** 中的历史 `~/.claude` 引用保持不变（历史记录，不应修改）
- **test/fixtures/** 中的 golden 文件保持不变（测试基准数据）
- **browse/test/fixtures/** 中的测试数据保持不变

## 为什么未兼容

- **`claude/` 技能**：依赖外部 `claude` CLI 二进制，Trae 不使用该 CLI，技能功能无法在 Trae 中实现。模板文件已从适配工作区完全删除
- **`codex/` 和 `openclaw/`**：均为非 Trae 平台专用功能（OpenAI Codex CLI 和 OpenClaw 代理），Trae 环境中无对应工具和运行时，已彻底删除无需保留
- **`contrib/add-host/`**：面向 gstack 开发者的工具，不是面向最终用户的技能。在 Trae 适配中不属于必要范围
- 测试文件和 fixtures 在 Trae 环境中不会直接执行，修改可能引入不一致
- 历史文档和 changelog 反映上游开发历程，修改会丢失历史上下文