概要说明
Project 将 Host、工作目录、项目私有 Action 和 Snippet 结构化关联。打开 Project 就能恢复一个代码仓的操作上下文,不必反复切换目录、寻找命令或重新组织启动步骤。
Project Action 会复制到项目内部,可以单独修改而不影响启动台中的公开 Action。因此同一 Host 上的不同仓库可以使用各自的参数、包管理器、测试目标和 Agent Prompt。
适用场景
- 反复进入同一个代码仓、monorepo 子包、服务目录或基础设施工作区时,一键回到固定目录。
- 把项目专属的 Agent 启动、测试、构建、预览、发布和部署命令放在工作目录旁边。
- 维护仅对当前代码库有意义的 Snippet,例如分支检查、包过滤、日志路径或固定 Prompt。
- 同一台 Mac 或服务器上存在多个仓库时,明确区分上下文,确保终端与 Action 总是从正确路径启动。
- 为日常开发、测试环境运维、文档维护或故障处理建立稳定、可重复的移动入口。
每天反复进入同一个代码仓
只需配置一次 Host 和准确的工作目录。以后从 Project 启动终端、Agent 或 Action 时都会自动位于该目录,避免误在父目录、旧 checkout 或另一个仓库执行命令。
区分 monorepo 中的不同子项目
可以分别为前端、API、移动端和基础设施包建立 Project,并为每个项目配置独立的测试过滤条件、dev server、构建命令和 Prompt Snippet。
把运维上下文集中到一个入口
处理测试环境或线上故障时,将服务目录、日志命令、健康检查、重启 Action 和诊断 Prompt 放进同一个 Project,减少紧急情况下找路径、找命令的时间。
使用流程
- 选择 Host,并设置项目工作目录。
- 添加这个仓库会使用的 Action 和 Snippet。
- 需要终端、Agent 或重复任务时,从 Project 进入正确上下文。
使用建议
建议每个仓库或服务建立一个 Project。准确的 working directory 能让终端和 Action 在启动前就明确执行上下文,减少误操作。