迁移到 Sourcery 前要准备什么
在「编程与开发」类工具里,Sourcery 的定位是:AI 代码审查与重构建议工具。
换工具的成本常被低估,这篇按步骤列出迁移前后要做的事。
以从 CodeRabbit 迁移为例
迁移不一定是「全面替换」。很多团队会先把一部分任务交给 Sourcery,与 CodeRabbit 并行一段时间再决定。
迁移步骤
- 盘点资产:现在用的提示词、模板、知识库、自动化流程和历史产出。
- 确认导出方式:哪些能导出、格式是什么、哪些只能手工迁移。
- 挑 3 个典型任务(如「补单元测试」「代码审查」)在两边同时做。
- 按同一张评分表比较结果。
- 迁移账号与权限,通知团队新的使用规范。
- 保留旧工具一段时间的只读访问,确认无遗漏后再停用。
对比测试用的任务
补单元测试
输入:一个缺少测试的函数或模块。
为【函数名】编写单元测试,覆盖正常输入、边界值和异常输入,使用项目现有的测试框架,不要修改被测代码。先列测试用例再写代码。
交付前确认:测试能在本地通过。
不建议迁移的情况
- 核心流程依赖 CodeRabbit 特有的功能或集成。
- 团队刚刚完成培训,切换成本过高。
- 新工具的数据处理条款不满足要求。
补充练习
修复报错
准备材料:一段报错堆栈和相关代码。
这是报错信息和相关代码。请先解释报错原因,给出最小修改方案,并说明为什么这个修改不会影响其他调用方。
检查点:修改范围足够小。
读懂陌生代码库
准备材料:一个刚接手的项目仓库。
先不要改任何代码。请阅读这个仓库,输出:1)目录结构说明;2)主要模块之间的调用关系;3)本地运行步骤;4)你认为最脆弱的 3 个地方。
检查点:运行步骤能实际跑通。
小功能开发
适用情况:手头有一个清晰的需求描述时。
实现以下需求:【需求】。要求:先给出实现计划和要改动的文件列表,等我确认后再写代码;遵循现有代码风格;补充必要的测试。
验收标准:先有计划再动手。
常见问题:生成的代码引用了不存在的函数
让它先搜索代码库确认 API,再写实现;运行测试验证。
常见问题:越改越乱
回滚到上一个可用提交,把需求拆小后重新开始。
常见问题:AI 改动范围过大
要求先给计划和文件清单,限定只改指定文件。
概念补充:规则文件
放在仓库里的说明文件,告诉 AI 项目约定和禁止事项。
概念补充:差异审阅
在接受 AI 修改前逐个查看 diff,是最重要的安全习惯。
适合人群:科研人员
科研人员可以用 Sourcery 处理文献检索与阅读、实验记录与数据整理等工作。需要注意:遵守期刊和机构关于 AI 使用的披露要求,引用逐条核对。
适合人群:设计师
设计师可以用 Sourcery 处理灵感与草图、多尺寸物料适配等工作。需要注意:确认生成素材与字体的商用授权,客户未公开的项目不要上传。
适合人群:软件工程师
软件工程师可以用 Sourcery 处理代码阅读与重构、测试与排错等工作。需要注意:不要把密钥和未开源代码上传到未授权工具,合并前审阅每处改动。
注意事项
文中提示词和示例仅作示意,实际效果取决于你的材料和 Sourcery 当前版本,重要内容请人工核对后再使用。
涉及个人信息、商业机密或受监管数据时,先确认 Sourcery 的数据处理条款,再决定能否使用。