跳到主要内容

查找规范

学习如何使用搜索、列表命令和 MCP 服务器发现和导航规范以供 AI 代理访问。

快速发现​

列出所有规范​

# 显示所有规范
lean-spec list

输出：

📋 Specs (18 total)

┌─────┬────────────────────────┬──────────────┬──────────┐
│ ID  │ Name                   │ Status       │ Priority │
├─────┼────────────────────────┼──────────────┼──────────┤
│ 042 │ auth-refactor          │ in-progress  │ high     │
│ 043 │ api-redesign           │ planned      │ medium   │
│ 044 │ dashboard-performance  │ complete     │ low      │
└─────┴────────────────────────┴──────────────┴──────────┘

按状态过滤​

# 仅显示进行中的规范
lean-spec list --status in-progress

# 显示计划中的规范
lean-spec list --status planned

# 显示已完成的规范
lean-spec list --status complete

按标签过滤​

# 显示带特定标签的规范
lean-spec list --tag api

# 显示带多个标签的规范
lean-spec list --tag api --tag backend

按优先级过滤​

# 高优先级规范
lean-spec list --priority high

# 低优先级规范
lean-spec list --priority low

按内容搜索​

基本搜索​

# 搜索所有规范内容
lean-spec search "authentication"

搜索范围：

  • 规范标题和描述
  • 所有 README.md 内容
  • 子规范文件（DESIGN.md、TESTING.md 等）
  • 前置元数据字段

使用过滤器搜索​

# 在特定状态中搜索
lean-spec search "API" --status in-progress

# 使用标签过滤器搜索
lean-spec search "cache" --tag performance

# 组合多个过滤器
lean-spec search "refactor" --status planned --tag backend --priority high

不区分大小写搜索​

搜索默认不区分大小写：

lean-spec search "api"      # 匹配 "API"、"api"、"Api"
lean-spec search "JWT"      # 匹配 "jwt"、"JWT"、"Jwt"

可视化导航​

看板​

lean-spec board

按状态分组显示规范：

┌─────────── PLANNED ───────────┬──── IN-PROGRESS ────┐
│ 043 api-redesign [medium]     │ 042 auth-refactor   │
│ 045 notification-system [low] │ 046 db-migration    │
└───────────────────────────────┴─────────────────────┘

项目完成度：60%（3/5 个规范完成）
- 2 个进行中，2 个计划中，3 个完成

另见：看板与统计

依赖视图​

# 显示规范的依赖关系
lean-spec deps 042

输出：

042-auth-refactor 的依赖图

依赖于：
  → 041-jwt-library [complete]       # 开始前需要

被需要：
  ← 043-api-redesign [planned]       # 在 042 完成前被阻塞
  ← 044-dashboard [planned]

相关规范：
  ⟷ 045-security-audit [in-progress]  # 协调工作

导航关系：

  • 依赖于（→）：此规范在开始前需要什么
  • 被需要（←）：等待此规范的内容被阻塞
  • 相关（⟷）：信息连接

另见：依赖关系

AI 代理访问（MCP）​

MCP 服务器集成​

LeanSpec MCP 服务器使 AI 代理能够搜索和检索规范：

// AI 代理使用 MCP 工具
search_specs("authentication system")
get_spec("042")
list_specs({status: "in-progress"})

这支持：

  • 语义记忆：AI 跨会话检索过去的决策
  • 上下文感知：AI 为当前任务查找相关规范
  • 交叉引用：AI 自动跟随依赖关系

另见：MCP 服务器参考

AI 搜索工作流程​

与 AI 代理一起工作时：

  1. 代理查询："我们为什么选择 PostgreSQL？"
  2. MCP 搜索：search_specs("database decision")
  3. 代理检索：带有理由的规范 023
  4. 代理回答："根据规范 023，选择 PostgreSQL 是因为..."

这消除了重复性问题并保持一致性。

高级过滤​

组合多个标准​

# 计划中的高优先级后端工作
lean-spec list --priority high --tag backend --status planned

# 进行中的 API 工作
lean-spec list --status in-progress --tag api

# 已完成的安全工作
lean-spec list --status complete --tag security

排除已归档​

默认情况下，lean-spec list 排除已归档的规范：

# 默认：排除已归档
lean-spec list

# 包括已归档
lean-spec list --archived

项目统计​

快速概览​

lean-spec stats

输出（默认简化视图）：

📊 项目统计

状态分布：
  ⏳ 进行中：2
  📋 计划中：5
  ✅ 完成：3

优先级细分：
  🔴 高：3
  🟠 中：4
  🟢 低：3

热门标签：
  #api：4 个规范
  #backend：6 个规范
  #security：2 个规范

另见：看板与统计

常见搜索模式​

查找要开始的工作​

# 准备开始的工作是什么？
lean-spec list --status planned --priority high

检查活动工作​

# 进行中的是什么？
lean-spec list --status in-progress

# 谁在做什么？
lean-spec list --status in-progress
# （如果设置则显示负责人）

审查已完成的工作​

# 最近完成的
lean-spec list --status complete

# 按标签完成的工作
lean-spec list --status complete --tag api

检查依赖关系​

# 准备开始的是什么？
lean-spec list --status planned

# 检查是否满足依赖关系
lean-spec deps <spec-id>
# （验证所需规范已完成）

导航提示​

做：

  • ✅ 使用 lean-spec board 进行可视化概览
  • ✅ 使用带过滤器的 lean-spec list 进行聚焦视图
  • ✅ 使用 lean-spec search 进行基于内容的发现
  • ✅ 使用 lean-spec deps 了解关系
  • ✅ 让 AI 代理通过 MCP 搜索进行语义检索

不要做：

  • ❌ 手动 grep specs/ 目录
  • ❌ 依赖文件系统命名（改用 ID/搜索）
  • ❌ 忘记已归档的规范存在（使用 --archived 包括它们）

键盘驱动工作流程​

快速发现流程​

# 1. 项目状态如何？
lean-spec board

# 2. 我应该做什么？
lean-spec list --status planned --priority high

# 3. 这个规范是关于什么的？
lean-spec view <spec-id>

# 4. 开始工作
lean-spec update <spec-id> --status in-progress
lean-spec open <spec-id>

研究流程​

# 1. 查找相关规范
lean-spec search "authentication"

# 2. 查看有希望的规范
lean-spec view 042

# 3. 检查相关工作
lean-spec deps 042

# 4. 阅读相关规范
lean-spec view 041

下一步​

参考：CLI 文档了解完整的命令选项