Warp Agentic Terminal 教程：从仓库规则、代码修改到人工审批与云端任务

这篇教程会完成什么

这篇教程不会追求“一句话生成整个应用”。目标是建立一个可以长期复用的 Warp 工作流：让 Agent 先读项目规则，再处理一个边界清楚的小任务；命令和文件修改保持可见；测试失败时停止；最后由人审查 Diff 并决定是否提交。

完成后你会得到：

• 一套适用于 macOS、Windows 或 Linux 的基础设置。
• 一个写清楚范围、验证命令和禁止事项的仓库规则。
• 一次从计划、修改、测试到 Review 的完整任务。
• 一份决定哪些任务可以交给云端 Agent 的检查清单。
• 一个记录 credits、返工和审查时间的成本方法。

开始前需要准备

选择一个非生产、可本地运行、已有 Git 和测试的仓库。最好创建独立练习分支，并保证工作区没有不明来源的改动。

任务应控制在 30 到 60 分钟内，例如：

• 修复一个已有复现步骤的 Bug。
• 给一个纯函数补边界检查和单元测试。
• 替换一个已弃用 API，但不升级整个依赖树。
• 为现有命令增加参数校验和错误提示。

不要从数据库迁移、身份认证、支付、云资源或生产部署开始。这些任务的外部副作用太大，不适合第一次测试 Agent 权限。

同时记录基线：当前测试结果、分支名、未提交文件和预期改动范围。若仓库包含客户数据、私钥或生产配置，先移除或改用干净副本。

第一步：安装 Warp 并确认平台限制

Warp 支持 macOS、Windows 和 Linux。可从官网下载，macOS 也可使用 Homebrew，Windows 可使用 WinGet，Linux 提供常见发行版包与 AppImage。

安装后先把 Warp 当普通终端使用，确认：

1. 默认 Shell、PATH 和包管理器正确。
2. Git 身份、SSH Agent 和凭据来源符合预期。
3. 项目启动、测试和格式化命令在 Warp 中能正常运行。
4. 在 Windows 上确认使用 PowerShell、WSL 或 Git Bash 的具体路径。
5. 在远程或 SSH 场景中确认文件树、代码编辑和索引功能是否可用。

不要在第一天导入所有 Shell 配置。先使用最小配置，排除主题、插件和启动脚本带来的干扰。

第二步：先配置隐私、数据和成本

打开 Warp 设置，检查隐私、遥测、云端会话和代码库索引。团队管理员还应查看数据控制、Agent 自主等级、目录和命令策略。

建议初始配置：

• 只索引练习仓库，不自动索引新目录。
• 关闭不需要的遥测或内容收集。
• 不上传包含客户信息、凭据或受限代码的仓库。
• 把 Agent 自主等级设为每次敏感操作都询问。
• 暂时禁用自动充值，先观察一个计费周期。
• 为云端会话设置保留和删除规则。

Warp 的免费版可体验核心终端、Agent CLI 和有限云端能力。Build 提供更多 credits 和完整 Agent 使用，额外用量仍可能按量计费。开始前记下当前 credits，任务结束后再记录一次，建立真实成本基线。

第三步：写清仓库规则

Agent 不会自动知道团队约束。可以在仓库中维护 AGENTS.md 或 Warp Rules，至少写清以下内容：

## Scope
- Only edit src/parser.ts and tests/parser.test.ts
- Do not change public API names
- Do not add dependencies

## Validation
- npm test -- parser
- npm run typecheck
- npm run lint

## Safety
- Do not access network services
 Do not read .env or credential files
 Ask before deleting or moving files
 Stop after two failed implementation attempts