场景
用 Matcha CLI 工作的六种方式，从最初的方案到最后一轮测试。
插图用于解释工作流程。CLI 示例及测试结果均为示意，并非产品截图或实际运行记录。
01
需求已经清楚，接下来把它写进仓库，并确认运行结果。
在现有流程中，加入一处明确的改动
从一句提示开始
给 API 加上限流，并补好测试。
工作如何展开
阅读处理函数及测试，了解现有行为。
加入限流逻辑，覆盖限额以内和超出限额的请求。
运行测试，检查结果，并审阅代码差异。
你会得到什么
一处明确的改动，以及覆盖新行为的测试。
CLI 流程示意
给 API 加上限流，并补好测试。正在读取 src/api/route.ts 与 src/api/route.test.ts
- export const POST = handler+ export const POST = withRateLimit(handler)示意结果：已加入限流，12 个测试通过。
02
方向已经明确，但在动手之前，还值得想清楚怎么走。
先看清改法，再开始修改
从一句提示开始
/plan 把 auth 从 cookie 迁到 JWT，先别改文件。
工作如何展开
用 /plan 进入计划模式，或用 /plan <description> 同时开始规划。
阅读认证流程，梳理迁移步骤、取舍与测试。
审阅方案，确认后再进入实现。
你会得到什么
先看到一份可以审阅的方案，再改代码。
CLI 流程示意
/plan 把 auth 从 cookie 迁到 JWT，先别改文件。正在读取 src/auth.ts 与 src/middleware.ts
1. 梳理会话处理与迁移风险2. 规划 token 校验与回归测试方案已准备好，等待审阅。尚未修改文件。
03
失败的测试给出了起点，沿着它找到需要修正的行为。
保留断言，修正行为
从一句提示开始
修好失败的 auth 测试并重跑，保留过期边界的断言。
工作如何展开
检查失败原因：会话应在到达过期时间时失效。
修正实现中的比较条件，保留边界断言。
重新运行认证测试，检查结果。
你会得到什么
修正实际行为，同时保留防止问题重现的测试。
CLI 流程示意
修好 auth 测试，保留过期边界的断言。失败原因：now 等于 expiresAt 时会话仍有效。正在读取 src/auth.ts。
- const expired = expiresAt < now;+ const expired = expiresAt <= now;示意结果：3 个认证测试通过，边界断言保持不变。
04
想让另一个已配置的模型接手下一轮，继续当前会话中的工作。
让正在进行的工作，多一个视角
从一句提示开始
/model <name>
工作如何展开
选择已配置服务商提供的可用模型。
将 <name> 换成模型 ID 或显示名称。只输入 /model 会显示用法。
在同一会话里，用选定的模型继续工作。
你会得到什么
为下一步换一个模型，当前会话继续保留。
CLI 流程示意
/model <name>将 <name> 换成已配置的可用模型 ID 或显示名称。
会话 · 当前工作下一轮 · 已选定的配置模型流程示意：在同一会话中继续。只输入 /model 会显示用法。
05
仓库里已经写明了工作方式，就从这些共同约定开始。
AGENTS.md · CLAUDE.md · Cursor rules
从一句提示开始
按仓库里的约定继续改。
工作如何展开
读取仓库中已有的 AGENTS.md、CLAUDE.md 和 Cursor rules。
用相关约定指导实现与检查。
结合项目的构建方式，审阅这次改动。
你会得到什么
让已有的仓库约定成为这次工作的依据。
CLI 流程示意
按仓库里的约定继续改。正在读取仓库中已有的项目说明。
上下文 · 项目约定改动 · 遵循相关说明流程示意：将仓库约定应用到当前任务。
06
把任务接到已有的命令或脚本里，给出提示，然后读取结果。
从一句提示，到一份可用的结果
从一句提示开始
matcha -p "fix the failing auth test and run it"
工作如何展开
从命令或脚本中，用 matcha -p 传入提示。
CLI 在本地工作，使用本轮可用的工具和权限。
本轮完成后打印结果，进程随后退出。
你会得到什么
把一轮 CLI 工作接进你已有的脚本。
CLI 流程示意
matcha -p "fix the failing auth test and run it"正在检查 src/auth.test.ts 与 src/auth.ts 中的过期边界问题。
- const expired = expiresAt < now;+ const expired = expiresAt <= now;示意结果：3 个测试通过。打印结果后进程退出。
Matcha CLI
打开仓库，带上明确的想法。与 Matcha CLI 一起迈出下一步。
开始使用Matcha CLI 在本地运行，会话和规则保存在你的机器上。模型请求发往你选择的服务商。MatchaCode 无需账号，也没有官方云。