第 11 章 · CLI 产品化与毕业
05 · 毕业项目
在真实仓库中完成一次完整任务——从理解需求到验证结果,把所有章节的能力串联起来。
毕业任务
mini-coding-agent 已经具备了完整的能力闭环。以下是一个可以用它完成的典型任务:
任务: "找到项目中所有没有对应测试的 TypeScript 文件,并生成测试文件的骨架"
这个任务需要 agent:
- 搜索所有
src/下的.ts文件 - 搜索所有
test/下的.test.ts文件 - 对比找出没有测试的源文件
- 为每个没有测试的文件生成测试骨架
- 运行测试验证生成的文件能通过
执行方式(交互模式):
mca
> 找到所有没有测试的 TypeScript 文件,为每个生成测试骨架执行方式(单次模式):
mca ask "找到所有没有测试的 TypeScript 文件,为每个生成测试骨架" --json执行方式(使用 delegate):
如果任务很复杂,agent 可能自动调用 delegate_tasks 工具,拆分为:
- [explorer] 搜索源文件和测试文件,找出差异
- [editor] 为每个缺失的测试文件生成骨架
- [reviewer] 运行测试验证
能力矩阵回顾
这个毕业任务用到了课程中所有章节的能力:
| 章节 | 能力 | 在任务中的应用 |
|---|---|---|
| 1 | 最小 agent | 调用模型、返回结果 |
| 2 | ReAct 循环 | 多步骤搜索和修改 |
| 3 | 工具箱 | search、glob、read_file、write_file、run_command |
| 4 | 权限系统 | 写文件前确认 |
| 5 | 事件流 | 终端实时显示进度 |
| 6 | 记忆 | 记住已读文件,避免重复搜索 |
| 7 | Skill | 自动匹配到 "refactor" 技能 |
| 8 | Hook | 审计日志记录所有操作 |
| 9 | MCP | (如果有外部工具)调用文档查询 |
| 10 | 多 agent | 复杂时委托 subagent 执行 |
| 11 | CLI | 正式的命令行接口、退出码 |
验收标准
毕业项目的验收标准:
- 能完成闭环。 从理解任务到输出结果,不需要人工干预。
- 工具使用正确。 搜索用 search、读取用 read_file、修改用 patch_file。
- 权限生效。 修改文件时请求确认。
- 事件流正常。 终端实时显示执行过程。
- 测试全部通过。 187 个测试用例绿色。
登录以继续阅读
解锁完整文档、代码示例及更多高级功能。