SillySpec

Appearance

五分钟上手 SillySpec ​

跟着以下步骤，你将在五分钟内体验完整的规范驱动开发流程。

前置条件 ​

确保你已经完成 环境准备：

  • ✅ Node.js v18+ 已安装
  • ✅ Git 已安装
  • ✅ Claude Code 已安装并登录（或已配置智谱 GLM）

Step 1：创建测试项目 ​

bash
mkdir ~/test-sillyspec && cd ~/test-sillyspec
git init

一个空的 Git 仓库就够了，SillySpec 会在里面生成所有需要的文件。

Step 2：运行 init.sh 安装 SillySpec ​

bash
curl -fsSL https://raw.githubusercontent.com/q512426816/sillyspec/main/scripts/init.sh | bash

脚本会自动完成以下操作：

  • 创建 .sillyspec/ 目录结构
  • 生成初始的 CLAUDE.md 规范文件
  • 配置 Claude Code 的自定义命令
  • 创建 .gitignore 规则

看到 ✅ SillySpec installed successfully! 即表示安装成功。

Step 3：启动 Claude Code ​

bash
claude

Claude Code 会自动读取项目根目录的 CLAUDE.md，加载 SillySpec 的规范和命令。

Step 4：运行头脑风暴 ​

在 Claude Code 的交互界面中输入：

/sillyspec:brainstorm 做一个简单的 todo app，支持添加、完成、删除任务

AI 会开始头脑风暴流程，向你提出一系列问题来明确需求：

  • 技术栈偏好（React? Vue? 纯 HTML?）
  • 数据存储方式（localStorage? 后端数据库?）
  • UI 风格偏好
  • 其他功能需求

如实回答即可，AI 会根据你的回答生成完整的项目规范。

Step 5：跟着 AI 走完流程 ​

头脑风暴完成后，AI 会自动：

  1. 生成规范文档 → .sillyspec/spec.md
  2. 拆解任务 → .sillyspec/tasks/ 下的任务文件
  3. 逐个实现 → AI 按任务列表逐步生成代码
  4. 验证结果 → 检查实现是否符合规范

你只需要在每一步确认或提出修改意见。整个过程就像和一个经验丰富的结对编程伙伴合作。

预期结果 ​

完成后，你的项目目录结构大致如下：

~/test-sillyspec/
├── CLAUDE.md              # SillySpec 核心规范（Claude Code 自动加载）
├── .sillyspec/
│   ├── spec.md            # 项目规范文档
│   ├── tasks/             # 任务分解文件
│   │   ├── 01-setup.md
│   │   ├── 02-ui.md
│   │   └── 03-storage.md
│   └── changelog.md       # 规范变更记录
├── src/                   # AI 生成的源代码
├── index.html
└── package.json

打开 index.html 或启动开发服务器，你的 todo app 就能跑了！

遇到问题？ ​

  • 安装脚本失败？检查 Node.js 版本是否 ≥ v18
  • Claude Code 无响应？检查网络连接和 API Key 配置
  • 生成代码不符合预期？重新运行 /sillyspec:brainstorm 修正需求

更多问题请查看 常见问题 或提交 GitHub Issue。