第 11 章 · CLI 产品化与毕业

05 · 毕业项目

在真实仓库中完成一次完整任务——从理解需求到验证结果,把所有章节的能力串联起来。

毕业任务

mini-coding-agent 已经具备了完整的能力闭环。以下是一个可以用它完成的典型任务:

任务: "找到项目中所有没有对应测试的 TypeScript 文件,并生成测试文件的骨架"

这个任务需要 agent:

  1. 搜索所有 src/ 下的 .ts 文件
  2. 搜索所有 test/ 下的 .test.ts 文件
  3. 对比找出没有测试的源文件
  4. 为每个没有测试的文件生成测试骨架
  5. 运行测试验证生成的文件能通过

执行方式(交互模式):

mca
> 找到所有没有测试的 TypeScript 文件,为每个生成测试骨架

执行方式(单次模式):

mca ask "找到所有没有测试的 TypeScript 文件,为每个生成测试骨架" --json

执行方式(使用 delegate):

如果任务很复杂,agent 可能自动调用 delegate_tasks 工具,拆分为:

  • [explorer] 搜索源文件和测试文件,找出差异
  • [editor] 为每个缺失的测试文件生成骨架
  • [reviewer] 运行测试验证

能力矩阵回顾

这个毕业任务用到了课程中所有章节的能力:

章节能力在任务中的应用
1最小 agent调用模型、返回结果
2ReAct 循环多步骤搜索和修改
3工具箱search、glob、read_file、write_file、run_command
4权限系统写文件前确认
5事件流终端实时显示进度
6记忆记住已读文件,避免重复搜索
7Skill自动匹配到 "refactor" 技能
8Hook审计日志记录所有操作
9MCP(如果有外部工具)调用文档查询
10多 agent复杂时委托 subagent 执行
11CLI正式的命令行接口、退出码

验收标准

毕业项目的验收标准:

  1. 能完成闭环。 从理解任务到输出结果,不需要人工干预。
  2. 工具使用正确。 搜索用 search、读取用 read_file、修改用 patch_file。
  3. 权限生效。 修改文件时请求确认。
  4. 事件流正常。 终端实时显示执行过程。
  5. 测试全部通过。 187 个测试用例绿色。

登录以继续阅读

解锁完整文档、代码示例及更多高级功能。

立即登录

On this page