# Trae Workspace Tool

Trae IDE 企业内网工作区生成器。它把企业通用安全规则、角色/场景 pack、Trae Rules、Trae Skills、Agent prompt、辅助脚本和使用说明安装到目标项目中，降低企业内网团队使用 Trae IDE 的门槛。

P0 阶段只内置：

- profile：`internal-basic`
- pack：`ops`

## 用法

```bash
uv run trae-workspace-tool list-profiles
uv run trae-workspace-tool list-packs
uv run trae-workspace-tool init --target /path/to/project
uv run trae-workspace-tool doctor --target /path/to/project
```

显式指定 profile 和 pack：

```bash
uv run trae-workspace-tool init \
  --target /path/to/project \
  --profile internal-basic \
  --pack ops
```

## 生成内容

`internal-basic` profile 生成企业通用安全规则：

- `.trae/rules/enterprise-safety.md`

`ops` pack 生成运维工作区资产：

- `.trae/rules/ops-safety.md`
- `.trae/skills/ops-maintenance-automation/SKILL.md`
- `docs/trae-agents/ops-maintenance-agent-prompt.md`
- `scripts/maintenance_check.py`
- `docs/trae-ops-maintenance/README.md`

## Trae 设置步骤

1. 打开目标项目。
2. 确认 Settings > Rules 中项目规则已可见。
3. 确认 Settings > Skills & Commands 中项目 Skill 已可见。
4. 使用 `docs/trae-agents/ops-maintenance-agent-prompt.md` 的内容创建自定义 Agent。

## 安全边界

- 默认只读 / dry-run。
- 生成脚本不删除、不移动、不重启、不改配置。
- 禁止读取密钥、Token、Cookie、私钥、`.env` 和数据库连接配置。
- 禁止外发内部代码、日志、客户数据和业务数据。
- 涉及生产变更、数据修改、服务重启、权限变更或破坏性动作时，必须先输出计划、风险、回滚方式和验证命令，并等待人工确认。

## 验证

```bash
uv run pytest -q
uv run ty check src tests
uv run ruff check src tests
uv run trae-workspace-tool init --target /tmp/demo-project
uv run trae-workspace-tool doctor --target /tmp/demo-project
python3 /tmp/demo-project/scripts/maintenance_check.py --root /tmp/demo-project
```

如果本地 `.venv` 架构不匹配，先重建虚拟环境后再运行 `uv run ...`。
