场景
这些是用 Matcha CLI 可以做完的工作。
不是客户案例，也不是命令手册。
01
何时
需求已经清楚，要在仓库里改代码并确认能跑。
你怎么说
给 API 加上限流，并补好测试。
CLI 读相关文件，直接改代码。改动以 diff 出现在同一段对话里。
然后跑测试，从结果接着改。
没有账号，也没有官方云。会话留在你的机器上。
给 API 加上限流，并补好测试。
MatchaCode
正在读取 src/api/route.ts、src/api/route.test.ts
- export const POST = handler+ export const POST = withRateLimit(handler)
限流已加入，12 个测试通过。
02
何时
改法还不清楚，先改会走弯路。
你怎么说
把 auth 从 cookie 迁到 JWT。先给方案，先别改。
用 /plan 进入计划。助手先读代码、写方案。
你同意后再改文件。
改文件、跑命令前会先问你。
把 auth 从 cookie 迁到 JWT。先给方案，先别改。
MatchaCode
正在读取 src/auth.ts、src/middleware.ts
1. 抽出 token 签发，测试先不动2. 替换 cookie 读取，保留现有断言
等你同意后再改文件。
03
何时
测试红了，要顺着失败往下修。
你怎么说
修好失败的 auth 测试并跑一遍。
助手查看失败输出和相关测试，改实现或断言，再跑一遍。
排查问题就是这一轮：修测试、看失败。
不是一个单独的 Debug 产品。
修好失败的 auth 测试并跑一遍。
MatchaCode
正在检查失败输出与 src/auth.test.ts
- expect(session).toBeNull()+ expect(session.user.id).toBe("1")
3 个测试通过。
04
何时
同一段工作里，想换一个服务商提供的模型。
你怎么说
/model
打开当前服务商的模型列表，不用中断会话。
请求发往你选择的服务商。
MatchaCode 不是模型厂商。
/model
MatchaCode
正在打开当前服务商的模型列表
当前 · xAI · grok-4.5选择 · Anthropic · claude-opus-4-6
已切换当前会话的模型。
05
何时
项目里已经有约定，不必每轮重说。
你怎么说
按仓库里的约定继续改。
CLI 读取 AGENTS.md、CLAUDE.md 和 Cursor rules。
需要时用 /import-claude 先预览再导入。
规则在本地。没有插件市场。
按仓库里的约定继续改。
MatchaCode
正在读取 AGENTS.md、CLAUDE.md 与 .cursor/rules
预览 · CLAUDE.md导入 · 本地规则
项目规则已在上下文中。
/import-claude
预览导入
06
何时
要把一轮工作接到现有命令或脚本里。
你怎么说
修好失败的 auth 测试并跑一遍。
用 matcha -p 给一句提示。助手读、改、跑，打印结果后退出。
在你的机器上跑。
这不是官方云，也不是 CI 产品。
matcha -p "fix the failing auth test and run it"
MatchaCode
正在读取 src/auth.test.ts
- expect(session).toBeNull()+ expect(session.user.id).toBe("1")
3 个测试通过。进程退出。