我们习惯让 AI 直接回答需求:“加一个导出功能”“把列表改成分页”“重构这块逻辑”。它通常很快就会给出代码。但如果它理解错了需求,或者选错了模块,等问题暴露时,改动可能已经散落在好几个文件里。
有没有办法把“理解需求”和“修改代码”分成两个阶段?
把中间那一步变得可审阅
Jin 的做法是先生成 Intent:把用户目标、任务和受影响架构节点整理出来,再展示建议的架构差异。你可以先检查它准备改哪里、这些模块的职责描述是否合理,以及提案有没有遗漏重要约束。
只有批准后,才进入实施。发现提案跑偏时,可以继续澄清需求,而不是先接收一大批代码再回头拆解。
例如,“给项目列表增加服务端分页”还可以进一步写清楚:切换页码时保留筛选条件、展示加载和空状态、补充分页控件测试,并且不改变现有 API 响应格式。需求中的约束越清楚,提案就越容易审阅。
审批不是形式,而是一个暂停点
这个流程的价值不在于多一张图,而在于把决定权放回实施之前。人可以在改动尚未发生时判断方向,而不是只在代码完成后做被动的善后。
批准的架构决策会写入项目的 .jin/wal.jsonl。它记录 Intent、结构操作、审批和实现结果;团队可以像审阅其他项目变更一样,通过 Git 查看和合并这段历史。Jin 还会在实现后重新扫描,并检查实现是否符合批准的架构变化。
当然,审批不会自动保证方案正确,架构检查也不能代替测试。它们提供的是更清晰的决策过程和可追溯记录,最终判断仍然需要开发者来做。
一个更适合长期项目的节奏
如果你正在维护有明确模块边界的代码库,可以试试把工作流变成:描述需求、检查影响、批准提案、实施代码、验证架构、审阅结果。相比“让 AI 一口气改完”,多一个暂停点,换来的是更容易纠偏的过程。
Jin 是一款面向架构的桌面 Coding Agent,可连接 OpenAI 兼容服务或本地 Ollama。项目和安装包见:github.com/ZYF93/Jin