---
name: check-spec
category: check
command: spec
description: 检查项目是否符合元规范
triggers:
  - "检查 {project} 是否符合规范"
  - "检查 {project} 是否符合新规范"
  - "验证 {project} 项目结构"
  - "{project} 符合规范吗"
  - "@check/spec {project}"
---

# @check/spec - 规范检查

检查指定项目是否符合 0 级元规范定义的约束。

## 参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `project` | string | 是 | 项目名称或路径 |
| `--strict` | flag | 否 | 严格模式（检查所有可选项） |
| `--fix` | flag | 否 | 自动修复可修复的问题 |

## 执行步骤

### 1. 定位项目

```
项目路径: /Users/yibu/dev_workspace/vibe-coding-cn/{project}
```

### 2. 检查 1 级文件

| 检查项 | 必需 | 说明 |
|--------|------|------|
| `CLAUDE.md` | 是 | 项目配置文件 |
| `architecture.canvas` | 是 | 整体架构图 |

### 3. 验证 CLAUDE.md 内容

- 项目信息表格完整（名称、类型、子项目）
- 子项目列表（如有）
- 关联配置（Obsidian路径、Kanban ID）
- 开发命令

### 4. 验证 architecture.canvas

检查必须节点及颜色编码：

| 节点 | 颜色 | 必需 |
|------|------|------|
| title | "1" (红) | 是 |
| user-client | "4" (绿) | 如有 |
| admin-client | "5" (青) | 如有 |
| backend | "6" (蓝) | 是 |
| database | "2" (橙) | 是 |
| external | "2" (橙) | 如有 |

### 5. 检查 2 级子项目

对每个子项目重复检查：
- `{subproject}/CLAUDE.md`
- `{subproject}/architecture.canvas`（如需要）

## 输出格式

```
=== 规范检查报告: {project} ===

### 1级检查
[✓] CLAUDE.md 存在
[✓] 项目信息完整
[✓] architecture.canvas 存在
[✗] architecture.canvas 缺少 backend 节点

### 2级检查: {subproject}
[✓] CLAUDE.md 存在
[!] 建议添加 Kanban ID

---
总结: 5/6 通过, 1 错误, 1 警告
```

## 示例

```bash
# 基本检查
@check/spec tg-live-game

# 严格模式
@check/spec tg-live-game --strict

# 自动修复
@check/spec yshop --fix
```

## 自然语言等效

以下表达均可触发此命令：

- "检查 tg-live-game 是否符合规范"
- "检查 tg-live-game 是否符合新规范"
- "验证 tg-live-game 项目结构"
- "tg-live-game 规范检查"