假设你刚接手一个陌生仓库,任务是在里面加一个功能。直接让 Agent 动手,它多半会猜错入口、改错文件。
第一步不是写代码,而是建地图。先扫出架构和约定,再看文档和术语,最后才谈模块怎么切。顺序反了,后面全是返工。
地图有了还不够,得跑起来验证一遍。启动应用、走通主流程,才能确认自己理解的是不是真的。这一步不做,改动范围就只是猜测。
确认之后,改动要小、要能回溯。探索阶段的每次提交,都是给下一个人留的线索。
五张卡片按这个顺序展开,每张两个 Skill,接力完成从看懂到动手的全过程。
刚接手一个陌生仓库,Agent 最容易犯的错不是不会写代码,而是还没看懂就开始改。这 10 个 Skill 的顺序,就是先看清、再动手。
假设你刚接手一个陌生仓库,任务是在里面加一个功能。直接让 Agent 动手,它多半会猜错入口、改错文件。
第一步不是写代码,而是建地图。先扫出架构和约定,再看文档和术语,最后才谈模块怎么切。顺序反了,后面全是返工。
地图有了还不够,得跑起来验证一遍。启动应用、走通主流程,才能确认自己理解的是不是真的。这一步不做,改动范围就只是猜测。
确认之后,改动要小、要能回溯。探索阶段的每次提交,都是给下一个人留的线索。
五张卡片按这个顺序展开,每张两个 Skill,接力完成从看懂到动手的全过程。
扫描陌生仓库,生成架构图和新人入门指南,作为接手的第一张地图
根据当前代码库的技术栈,查找并安装后续分析所需的技能包
探测项目文档站点或内部知识库的全部 URL,列出可读的文档入口
抓取上一步列出的文档页面,提取术语表、运行说明和模块介绍
分析代码库并生成架构文档和可视化图表,补上模块关系
梳理陌生项目的目录结构、运行入口和关键代码路径
用 Playwright 跑通本地应用的启动与关键页面,确认运行方式可复现
录制并回放核心用户操作路径,验证对入口和主流程的理解是否正确
用深模块和接口边界的设计原则判断代码应该从哪里切开
把探索阶段的小改动按规范提交,留下可回溯的接手记录