spec.md 2.2 KB


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 警告

示例

# 基本检查
@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 规范检查"