我希望 TraeCode 未来可以真正「记住」我的项目规约,并在改完代码后自动同步关联面

我对TraeCode的未来愿景

介绍自己

我是做内容生产工具方向的前端开发,日常维护一套 批量生成 + 审核流转 的业务系统。

工作日常大概是三类:

  • 复杂业务逻辑:多组素材按规则自动组合、批量产出,既要跑得动,又要保证用量均衡,不能跑偏;

  • 跨模块改动:生成、管理、审核、导出几个模块互相咬合,动一个底层工具函数,往往要牵动好几个视图;

  • 大量"项目私有规矩":哪些值必须抽成常量、不同环境该用哪个请求实例、接口参数怎么组织——这些规矩不在任何公开文档里,只存在于团队的脑子里和既有代码里。

我对 TraeCode 的愿景

一、希望新增什么功能:项目规约感知 + 违规拦截

我们项目有几条「铁律」,但每次新开会话,我都得像带新人一样重讲一遍:

  • 禁用魔法数字,状态值统一走常量文件 痛:AI 改逻辑时顺手就写了个 if (type === 2)
  • 多个请求实例分工(正式环境 / 联调环境) 痛:新写的接口用错实例,联调直接 404
  • 接口查询入参有统一结构,且不同模块字段命名风格不一致 痛:字段名猜错,接口静默返回空数据,排查半天
  • 改了函数逻辑,必须同步更新方法上的备注注释 痛:逻辑改了三版,注释还停在初版,下一个人(包括三个月后的我)被误导

前三条我能靠 Code Review 兜住,第四条基本靠自觉——而自觉是最不靠谱的机制。

所以我希望 TraeCode 有一个「项目规约感知」能力:

  1. 规约自动沉淀:不是让我手写一份规则文档(我大概率不会写,写了也不会更新),而是扫描现有代码库自动归纳——“你们项目 87% 的状态值都来自常量文件”“这两个请求实例分别用于 A/B 场景”“这个模块的接口字段用的是别名风格”。定期增量更新,随代码演进。

  2. 生成时遵守,保存时拦截:写代码阶段默认按规约生成;当我(或 AI)写出违背规约的代码时,不是弹个警告就完事,而是直接给出符合规约的改写 diff,一键采纳。

  3. 注释同步:改动函数逻辑后,自动检测关联注释是否已过期,并给出更新建议。这条优先级不高,但对我这种"改完就走"的人来说,价值极高。

二、希望优化什么场景:跨文件重构时的「影响面地图」

目前跨文件重构最难受的不是写,是确认有没有漏

举个典型场景:我调整了某个核心算法的评分策略,需要同步改动:

  • 算法函数本体

  • 调用它的上层构建逻辑

  • 依赖该结构的若干视图组件

  • 相关的常量定义和注释

  • 一份"以为没人看但其实还在用"的接口说明文档

现在的流程是:全局搜函数名 → 逐个点开确认 → 凭记忆补齐文档 → 跑一遍看有没有崩。TraeCode 能帮我搜,但"哪些地方可能被遗漏"这件事依然靠人脑兜底。

我希望它能给出一张影响面清单

改动 核心算法 / 评分函数
├─ 直接影响(调用点 4 处)
├─ 间接影响(类型 / 常量 / 导出 3 处)
├─ 注释过期风险(2 处,已标注旧描述)
└─ 文档待同步(1 处:相关接口说明)

有这张清单,重构才敢下手。

三、希望如何融入我的工作流

  • 接 Git:作为 pre-commit 检查项,违背核心规约的代码不给提交(可配置白名单);

  • 接 Code Review:PR 里自动标注"此处偏离项目既有约定",reviewer 不用再当人肉 lint;

  • 接需求文档 / 知识库:从需求描述直接映射到"本次改动会触碰哪些既有约定",在动手前就提示;

  • 接团队协作:规约是团队资产,希望它能导出、共享、随人流动——新人接手项目时,第一天就能拿到一份"这个项目的规矩",而不是靠口口相传。

你希望它以什么形态出现

  • 面板优先:一个常驻的「项目规约」侧边面板,能看到当前项目沉淀了哪些规约、哪些是自动归纳的、哪些是我手动确认过的(置信度区分);

  • 触发方式:默认静默生效(生成即遵守),违规时在编辑器内行内提示 + 提供改写建议,而不是弹窗打断;

  • 一键导出规约文件:可导出为项目内配置文件,随仓库走,换机器、换同事都能复用;

  • 一步完成 vs 多步:规约沉淀建议做成多步智能体流程(扫描 → 归纳 → 人工确认 → 落盘),因为自动归纳的规约必须让人过一眼,否则容易把历史遗留的坏习惯也学进去——这个确认环节不能省

一句话总结

我不缺一个会写代码的 AI,我缺一个懂我们项目规矩、改完会帮我扫尾的 AI。

代码能生成,规约能学习,剩下的那点"别让我自己记着同步注释"的体贴,才是真正改变工作方式的部分。