跳到主要内容

LeanSpec 最新更新：示例项目、更强大的工具和快速上手指南

· 阅读需 6 分钟
Marvin Zhang
Marvin Zhang
LeanSpec Author

我们一直在努力让 LeanSpec 更易于上手和使用。无论您是第一次探索规格驱动开发，还是需要扩展到企业级工作流，这些更新都将加速您从意图到可运行代码的旅程。

新功能亮点：示例项目实现即时上手学习、JSON 输出支持自动化、简化的模板系统，以及 MCP 服务器集成的重大改进。

🚀 示例项目：几秒钟开始学习​

理解 LeanSpec 的最佳方式就是使用它。这就是我们构建示例项目脚手架的原因——完整的教程项目，您可以立即启动。

三个开箱即用的示例​

# 查看可用示例
npx lean-spec examples

# 初始化示例项目
npx lean-spec init --example dark-theme
cd dark-theme
npm install
npm start

每个示例都包含：

  • ✅ 完整的启动代码 - 可以立即构建的工作 React 应用
  • ✅ LeanSpec 已初始化 - Spec、模板和配置已就绪
  • ✅ 真实的功能 Spec - 可以遵循的真实示例
  • ✅ 教程友好 - 专为配合我们的实践教程设计

可用示例​

dark-theme - 为 React 应用添加暗黑模式
完美的第一个项目。学习基础：创建 Spec、与 AI 协作、跟踪进度。

dashboard-widgets - 构建可自定义的仪表板
多组件功能。练习拆分 Spec、管理复杂性、使用子 Spec。

api-refactor - 将 REST API 现代化为 GraphQL
后端专注示例。了解 LeanSpec 如何处理架构变更和迁移。

为什么这很重要​

有示例项目之前：

  • "如何构建 Spec？" → 阅读文档、猜测、迭代
  • "真实的 Spec 长什么样？" → 浏览 GitHub、适配到您的项目
  • "这能与我的 AI 工具配合吗？" → 尝试、调试、排查

有示例项目之后：

  • 克隆。运行。开始编码。
  • 使用可运行的代码跟随教程。
  • 清楚地看到 Spec 如何引导 AI Agent。

不再有空白页综合症。不再有"从哪里开始？"只有立即见效的实践学习。

🤖 更好的 AI 集成​

MCP 服务器作为独立包​

我们将 @leanspec/mcp 提取为独立的 npm 包。现在设置更简洁：

{
  "mcpServers": {
    "lean-spec": {
      "command": "npx",
      "args": ["@leanspec/mcp"]
    }
  }
}

适用于 Claude Desktop、Cline、Zed 和任何兼容 MCP 的工具。该服务器让 AI Agent 直接访问您的 Spec——无需复制粘贴，无上下文限制。

增强的依赖管理​

新命令让关系管理更清晰：

# 使用明确的依赖关系链接 Spec
lean-spec link feature-123 --depends-on auth-system

# 查看完整的依赖图
lean-spec deps feature-123

# 删除关系
lean-spec unlink feature-123 --from auth-system

更好的验证在问题发生前捕获循环依赖。

🔧 支持自动化的 JSON 输出​

所有主要命令现在都支持 --json 用于编程式使用：

# 集成到仪表板
lean-spec board --json | jq '.columns[] | select(.status=="in-progress")'

# 构建自定义工作流
lean-spec list --json --status=complete | jq -r '.[] | .name'

# 导出用于报告
lean-spec timeline --json > project-timeline.json

在 CI/CD 流水线、项目仪表板或自定义工具中使用 LeanSpec 数据。

📝 简化的模板系统​

我们移除了 Handlebars 模板层。模板现在只是 Markdown 文件，您可以直接编辑。

之前：编辑 .hbs 文件 → 运行构建 → 测试
之后：编辑 .md 文件 → 测试

两个模板涵盖所有场景：

  • standard（默认）- 大多数功能的单文件 Spec
  • detailed - 演示子 Spec 的多文件示例

无需构建步骤，无需学习模板引擎。只需 Markdown。

🌏 专业的中文翻译​

如果您与中文团队合作，我们的文档现已全面本地化，提供专业翻译。我们建立了严格的质量标准：

  • 技术术语保持英文（Spec、CLI、Token、MCP）
  • 自然的中文表达（非逐字翻译）
  • 所有文档中的一致术语
  • 完整覆盖指南、教程和 API 参考

访问 lean-spec.dev/zh-Hans 查看中文文档。

🎯 快速上手路径​

不确定从哪里开始？这是推荐的路径：

1. 理解原因（5 分钟）​

阅读为什么您的 AI Agent 在大型 Spec 中变笨，了解 LeanSpec 背后的上下文工程 (Context Engineering) 原则。

核心要点：这不是关于适应上下文窗口——而是关于在项目规模扩大时保持 AI 性能。

2. 启动示例项目（2 分钟）​

npx lean-spec init --example dark-theme
cd dark-theme
npm install

现在您有了一个已配置好 LeanSpec 的可运行 React 应用。

3. 跟随教程（10 分钟）​

打开使用 AI 创建您的第一个 Spec 教程。它将引导您完成：

  • 创建您的第一个 Spec
  • 与 AI 协作实现功能
  • 跟踪进度并完成工作
  • 了解 Spec 如何引导 AI 行为

使用您刚刚初始化的示例项目——它专为此教程设计。

4. 在自己的项目中尝试（准备好时）​

cd your-existing-project
npx lean-spec init
lean-spec create user-authentication

现在应用您学到的知识。从简单开始（status + created），根据需要添加结构（tags、priority、自定义字段）。

需要更多指导？​

下一步计划​

我们专注于让 LeanSpec 与更多 AI 工具和开发工作流无缝配合：

  • GitHub Copilot Workspace 集成 - 在 Copilot 的任务规划中原生支持 Spec
  • VS Code 扩展 - 内联 Spec 查看、验证和状态跟踪
  • 项目管理集成 - Jira、Linear 和 GitHub Projects 同步
  • 更多示例项目 - 后端 API、移动应用、基础设施

反馈塑造路线图。什么能让 LeanSpec 对您的工作流更有用？提交 Issue 或参与讨论。

立即尝试​

# 全局安装
npm install -g lean-spec

# 或使用 npx 一次性命令
npx lean-spec init --example dark-theme

学习的最快方式就是构建。选择一个示例，跟随教程，看看 AI 辅助的规格驱动开发如何改变您的工作流。

链接：

更新日志：详细版本历史请参阅 CHANGELOG.md。