Skip to content

术语表

SpecForge 中常见术语的快速参考 —— 用人话写的,不只是给开发者看的。


规格(Spec)

规格(Spec)(specification 的缩写)是你想构建的功能或改动的简短计划。把它想象成你和 AI 之间的约定:它描述了要构建什么如何运作,以及什么叫做完成

举例: 一个"Google 登录"的规格会包含:配置 OAuth 凭据、添加登录按钮、保存用户会话、登录后跳转页面。你的 AI 读取这些内容,然后一步一步照着执行。


完成检查清单

每个规格都有一份完成检查清单 —— 列出功能被认为完成之前必须满足的条件。它消除了模糊性:不再是"大概能用了",而是清楚地知道哪些条目已经完成、哪些还没有。


偏移(Drift)

偏移(Drift) 是指你构建的代码不再与原始规格相符的情况。这很正常 —— 需求会变化,开发时会走捷径,想法也会演进。SpecForge 能检测到偏移,并准确告诉你哪些地方偏离了原来的计划。

为什么重要: 如果没有偏移检测,你可能以为功能已经完成,但实际上关键部分缺失或已被修改。


MCP 服务器

MCP 服务器是一个插件,用于扩展你的 AI 工具(如 Claude、Cursor 或 Windsurf)的能力。SpecForge 以 MCP 服务器的形式在你的本地机器上运行 —— 你的 AI 可以调用它的工具来创建规格、验证代码、检测偏移等。

类比: 可以把它想象成浏览器扩展,但用于你的 AI 编程助手。


规格驱动开发(SDD)

规格驱动开发(SDD) 是一种开发方式,每个功能在写任何代码之前都先从一份清晰的规格开始。规格成为唯一的事实来源 —— 你的 AI 照着它执行,完成后你对照它来验收。

与之对比的是: 随机应变式开发 —— 在聊天框里描述你想要什么,然后希望 AI 能正确理解。


项目

在 SpecForge 中,项目是你电脑上已用 SpecForge 初始化过的一个文件夹。每个项目都有唯一的 ID,并在本地存储所有的规格、决策记录和指标数据 —— 无需云端。


流(Stream)

SpecForge 将其 59 个工具组织成 8 个流(Stream)(A 到 H)。每个流把功能相近的工具归为一组:规划、分析、设计、交付等。你不需要了解全部 59 个工具 —— 只需要关注与你当前任务相关的那个流就行。


验证

验证是指 SpecForge 读取你的代码,并与规格的完成检查清单进行比对。它会告诉你哪些条目已完成、哪些还缺失,以及与原始计划相比有哪些变化。

何时使用: 在你(或你的 AI)认为某个功能已经完成之后。


验收标准

验收标准是规格被认为完成时必须满足的具体条件。它们就是完成检查清单上的各个条目。每条标准都应该是具体且可验证的 —— 不是"登录应该能用",而是"成功登录后用户被跳转到 /dashboard"。


初始化

初始化项目是指将 SpecForge 指向你的项目文件夹,让它扫描你的代码库、检测你使用的语言和框架,并为你的规格配置本地存储。整个过程只需几秒钟,每个项目只需做一次。


模式

模式是 SpecForge 从你的项目中学到的一种重复出现的解决方案。随着时间推移,SpecForge 可以识别你代码库中的常见做法,并在创建新规格时主动建议使用它们 —— 让你的 AI 始终保持一致的构建风格。


技术债务

技术债务是指开发过程中被推迟的工作或走过的捷径。在 SpecForge 中,技术债务条目会单独记录在规格的进度文件里 —— 它们不会阻止规格被标记为"完成",但会被妥善记录,确保没有遗漏。


有想添加的术语?在下方留言或通过 npm 联系我们。