AI编程工具因会话中断导致计划丢失，是许多程序员的痛点。Spec Smith这款开源工具通过将开发计划转化为项目内的永久规格文件，实现了跨会话、跨工具的上下文留存，有效终结了无意义的重复返工，提升了开发效率。
智能速览
Spec Smith是一款开源免费工具，专为解决AI编程上下文丢失问题设计。
其核心是将AI聊天中的临时计划，转化为项目文件夹内的永久Markdown文件。
通过Forge工作流实现深度研究、迭代访谈、规格撰写和落地执行。
支持跨工具、跨会话读取计划，无缝衔接Claude Code、Cursor等主流工具。
决策日志与续读上下文功能，确保开发过程的每个细节都有据可查。
精华内容
要理解Spec Smith如何解决AI“失忆”问题，关键在于其将临时对话转化为结构化文档的持久化设计。下面将深入拆解其核心工作流与实际操作。
核心原理
Spec Smith并非要取代Claude Code或Cursor等现有AI编程工具，而是作为它们的辅助插件存在。其核心逻辑非常直接：在项目根目录下创建一个`.specs/`文件夹，将所有与AI沟通的计划、研究结论和决策记录，都以普通Markdown文件的形式永久保存下来。这意味着，无论你是关闭终端、重启电脑，还是从Claude Code切换到Cursor，这些关键信息都不会丢失。AI在新的会话中可以直接读取这些文件，瞬间恢复到上次中断的节点，从而实现了真正意义上的跨会话、跨工具上下文持久化。
Forge工作流
Spec Smith的精髓在于其独创的Forge工作流，它将一次模糊的开发需求，细化为一个结构清晰、可执行的开发规格。
第一步是深度研究。系统会自动扫描项目中的10-20个核心代码文件，分析目录结构、依赖关系，并搜索相关技术最佳实践，形成研究报告。
第二步是迭代访谈。基于研究结果，AI会提出具体问题，例如“发现你使用了Express中间件，新认证功能是否要遵循相同模式？”，确保所有细节都被明确。
第三步是规格撰写。将研究和访谈内容整合，生成一个包含任务列表、决策日志和续读上下文的SPEC.md文件，每个任务都有唯一编码和状态标记。
第四步是落地执行。开发者按照SPEC.md中的任务清单逐一完成并更新进度，确保计划与实际开发同步。
规格文件详解
SPEC.md是整个流程的核心，它是一个结构化的Markdown文件，人类和AI都能轻松理解。其中最关键的两个部分是“续读上下文”和“决策日志”。
续读上下文部分会详细记录开发中断时的精确状态。例如：“已完成Google OAuth开发，GitHub OAuth回调处理器正在src/auth/oauth/github.ts中开发，授权URL重定向正常，但回调端点需要将代码转换为令牌，可参考src/auth/oauth/google.ts第45-82行的模式。” 这段描述能让AI在几天后也能瞬间回到工作状态，无需任何额外解释。
决策日志则记录了所有非显而易见的技术选择及其背后的原因，比如为什么选择某个库、放弃某种架构模式，这为后续维护和团队协作提供了宝贵的上下文信息，避免了因信息不对称导致的重复讨论或错误决策。
优势与局限
Spec Smith的最大优势在于精准解决了AI编程中最耗费时间的“上下文丢失”痛点，显著提升了开发效率和项目连续性，尤其适合需要频繁切换任务或使用多工具的开发者。
然而，它也并非万能。它的核心价值是“管理计划”而非“优化代码”，因此无法直接帮助你写出更高质量的代码或排查复杂bug。其次，随着项目变复杂，若缺乏有效的文件分类管理，`.specs/`文件夹下可能会产生大量规格文件，增加后期管理成本。此外，过度依赖工具记录也可能让开发者忽视对核心逻辑的记忆与理解，一旦规格文件本身有误，可能导致开发方向偏离。
Spec Smith的出现，不仅是解决了一个即时痛点，更推动了AI辅助编程向更规范、更可持续的模式发展。它让AI开发从即兴对话变为可沉淀的结构化过程。未来，随着这类工具的成熟，程序员的工作流将迎来怎样的变革？这值得每一位开发者期待和思考。
