你可能遇到过这样的项目现场：代码在 Git 里，任务在看板里，真正影响方向的讨论却散落在几个 Agent 对话中。隔天回来，你知道项目“做过一些事”，却很难立刻回答三个问题：现在推进到哪一步？上一次为什么这样改？下一步做到什么程度才算完成？

这不是记忆力问题，而是项目上下文被拆散了。路线图如果只存在于项目之外，它很容易成为一张漂亮但滞后的计划表；代码继续变化，Agent 继续执行，路线图却停在昨天。

路线图最重要的作用，不是预测未来

很多人把路线图理解成一张按月份展开的承诺表。对一个正在用 AI Agent 快速迭代的独立项目来说，更有价值的定义其实更朴素：

路线图是项目当前位置的可恢复记录。

它至少要持续回答五件事：

  • 这个项目最终要解决什么问题；
  • 当前只推进哪个环节；
  • 这个环节明确不做什么；
  • 怎样验证结果已经成立；
  • 中断之后，下一次从哪里继续。

如果这五件事和代码彼此分离，路线图就只能描述愿望，无法约束执行。Agent 完成了大量修改，也不等于项目向目标前进了一步。真正的进展必须同时留下目标、边界、代码变化、验证结果和交接。

当路线图住在项目之外，会发生什么

独立的路线图服务当然有价值：它们适合跨团队协作、权限管理、报表和资源统筹。问题不在于“能不能使用 SaaS”，而在于它是否成了项目事实的唯一住处。

当计划与交付分离，最常见的代价有三种。

第一，状态要靠人手工同步

代码已经换了方案，路线图上的完成标准却还是旧版本；测试发现了新的边界，外部看板仍显示“进行中”。同步不是一次动作，而是一笔持续累积的维护债。

第二，Agent 只看见局部任务

一段临时提示可以告诉 Agent “改这个文件”，却未必告诉它为什么改、哪些边界不能动、结果如何验收。对话一旦结束，这些约束也容易一起消失。下一轮 Agent 只能重新猜测。

第三，中断恢复变成对话考古

你需要重新打开聊天、提交记录、任务卡和测试日志，拼出上一次的真实意图。项目越长，这种恢复成本越高。最麻烦的不是少记住一个细节，而是把旧决定误当成当前决定，再沿着错误方向继续。

把路线图保存成项目内文本，会改变什么

当路线图本身是项目中的文本文件，它就和代码共享同一个上下文。它可以被版本管理，可以在提交中与实现一起变化，也可以在分支和历史记录中解释“为什么现在是这个状态”。

这带来的不是形式上的“本地化”，而是四个直接结果。

1. 目标与实现一起演进

路线图环节、完成标准和代码变化可以出现在同一次交付中。你不需要依赖记忆去判断某个修改对应哪个目标，也更容易发现一次提交是否已经越过当前边界。

2. Agent 每次都从项目事实开始

新对话不必继承一整段旧聊天。只要项目保留了当前环节、约束、验证证据和交接摘要，Agent 就能从稳定状态继续，而不是从聊天语气里猜意图。

3. 计划变化可以被审查

路线图不是不能改。相反，它应该根据真实反馈调整。但调整本身也要留下记录：改了哪个目标、为什么改、会影响哪些环节。这样，“灵活”不会变成悄悄换目标。

4. 中断不再等于丢失方向

几天后、换一台终端、甚至换一个 Agent，你仍然能先看到项目现在的位置，再决定继续、暂停或调整。恢复动作从“重建上下文”变成“读取项目状态”。

本地记录不等于拒绝协作

让路线图住回项目，并不意味着所有东西都必须离线，也不意味着外部服务没有价值。更准确的边界是：项目继续推进所必需的核心记录，不应只存在于某段聊天或某个无法与代码共同演进的界面里。

团队仍然可以同步看板、生成报表或接入远程服务。但目标、当前环节、完成标准、交接和验证证据应该有一个贴近代码、可导出、可追溯的主记录。这样，工具可以替换，项目上下文不会随工具一起消失。

SoloMap 如何把这件事落到日常动作里

SoloMap 是一个面向本地 AI 编码 Agent 工作流的 VS Code 扩展。它把路线图保存为项目内的 .solopreneur/roadmap.csv，并在 VS Code 中连接项目、路线图环节、Agent 对话、交接和验证结果。

你可以从一个具体环节发起本地 Agent CLI，让这次执行带着明确目标和完成标准开始；结束时，把代码变化、验证结果和下一步留在同一个项目上下文中。下一轮不需要假装 Agent “记得一切”，只需要让它读取已经沉淀的项目事实。

SoloMap 支持多种本地 Agent CLI，也提供可选的第二 Agent 只读复核。它不会替你做产品判断，也不能保证 Agent 永不偏航；它做的是把方向、边界和证据变成可见、可恢复的工作状态。

用 15 分钟，让一个真实项目拥有第一版路线图

不必先设计一张覆盖全年的宏大计划。选一个你正在推进的真实项目，只回答下面四个问题：

  1. 最终结果：这个项目真正要让谁获得什么改变？
  2. 当前环节：接下来只推进哪一个可以闭环的结果？
  3. 完成标准：看到什么证据，才算这一环节已经成立？
  4. 交接信息：如果今天中断，下一次必须知道什么才能继续？

把答案写进项目，运行一个环节，再用真实结果更新路线图。第一版不需要完美，它只需要比散落在聊天里的计划更容易继续。

在 VS Code Marketplace 安装 SoloMap，为一个真实项目生成第一版路线图。也可以前往 GitHub 仓库 查看源码或提交反馈。