SillySpec

Appearance

5 分钟上手 ​

用一个真实的例子演示 SillySpec 的完整流程。

场景 ​

你有一个 Java Spring Boot 项目，现在要添加一个"用户注册"功能。

Step 1: 安装 ​

bash
npx sillyspec init

选择你用的 AI 工具，安装完成。

Step 2: 启动 AI 编码工具 ​

安装完 slash commands 后，还需要在 AI 编码工具中打开项目才能使用。

如果你用 Claude Code：

  1. 进入命令行界面，执行配置向导：
bash
npx @z_ai/coding-helper

通过键盘上下方向键选择，回车确认，根据引导完成配置。

  1. 启动 Claude Code 并打开项目：
bash
claude "中文回答我的所有问题" --dangerously-skip-permissions
  1. 在 Claude Code 的对话中输入 /sillyspec:scan 即可开始。

其他工具（Cursor、OpenClaw 等）请参考 多工具支持。

Step 3: 扫描项目 ​

/sillyspec:scan

选择深度扫描，SillySpec 会自动提取项目的架构、代码风格、框架约定。

产出：ARCHITECTURE.md、CONVENTIONS.md 等。

Step 4: 需求探索 ​

/sillyspec:brainstorm "用户注册功能：手机号+验证码注册，注册成功后自动登录"

AI 会引导你梳理需求、确认边界、产出技术方案 design.md。

Step 5: 编排任务 ​

/sillyspec:plan

把 tasks.md 轻量化展开：任务描述 + 文件路径 + Wave 分组。

Step 6: TDD 执行 ​

/sillyspec:execute

AI 按 TDD 流程逐任务执行：先读后写 + grep 确认 + 写测试 → 写代码 → commit 前确认。

完成 ​

/sillyspec:archive

归档变更，沉淀设计规范。

小修小补 ​

后续如果发现注册接口漏了参数校验：

/sillyspec:quick --change user-register "注册接口添加参数校验"

记录自动追加到变更的 tasks.md 中。

总结 ​

步骤命令耗时产出
安装npx sillyspec init命令文件
扫描/sillyspec:scan架构文档
探索/sillyspec:brainstormdesign.md
编排/sillyspec:plantasks.md（轻量展开）
执行/sillyspec:execute—代码 + 测试
归档/sillyspec:archive—规范沉淀

想了解更多？看 安装与初始化 或 与其他工具对比。