# sillyspec

**Repository Path**: iqiny/sillyspec

## Basic Information

- **Project Name**: sillyspec
- **Description**: SillySpec - AI 规范驱动开发工具包
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SillySpec v2.3 — 规范驱动开发工具包

> 融合 Superpowers + OpenSpec + GSD，从"你说要啥"到"代码能跑"的完整流程。
> Claude Code / Cursor / Codex / OpenCode / OpenClaw 都能用。
>
> 📖 **在线文档**：https://sillyspec.ppdmq.top/

## 安装

需要 Node.js >= 18。所有平台一条命令：

```bash
npx sillyspec init
```

> 📦 首次运行自动安装 CLI，之后 `sillyspec status`/`sillyspec next` 等命令也可直接使用。

**指定工具：**
```bash
npx sillyspec init --tool claude
npx sillyspec init --tool cursor
npx sillyspec init --tool openclaw
```

**工作区模式（多项目）：**
```bash
npx sillyspec init --workspace
```

**指定目录：**
```bash
npx sillyspec init --dir /path/to/project
```

### 支持的 AI 工具

| 工具 | `--tool` 参数 | 输出目录 | 格式 |
|---|---|---|---|
| Claude Code (commands) | `claude` | `.claude/commands/sillyspec/` | slash commands |
| Claude Code (skills) | `claude_skills` | `.claude/skills/sillyspec-<name>/` | SKILL.md |
| Cursor | `cursor` | `.cursor/commands/` | custom commands |
| Codex | `codex` | `~/.agents/skills/sillyspec-<name>/` | SKILL.md |
| OpenCode | `opencode` | `.opencode/skills/sillyspec-<name>/` | SKILL.md |
| OpenClaw | `openclaw` | `.openclaw/skills/sillyspec-<name>/` | SKILL.md |

安装后重新打开终端，启动 Claude Code：

```bash
claude --dangerously-skip-permissions
```

> 💡 **推荐使用跳过权限模式。** SillySpec 的命令会频繁执行 `git commit`、文件读写、校验脚本等操作，停下来 50 次批准会失去意义。这是 GSD 和 OpenSpec 的预期使用方式。

## 入口选择

```
绿地项目（空目录）：/sillyspec:init
棕地项目（有代码）：/sillyspec:scan
随时自由思考：      /sillyspec:explore "想法"
大模块（多页面）：  /sillyspec:brainstorm（直接贴原型图）
```

## 完整工作流

```
绿地：init → brainstorm → propose → plan → execute → verify → archive
棕地：scan → brainstorm → propose → plan → execute → verify → archive
大模块：brainstorm(多图) → 拆分 → MASTER.md → stage-1 全流程 → stage-2 全流程 → ... → archive
```

### 也可以跳过

- 小 bug：`/sillyspec:quick "修复 xxx"`
- 不确定要做什么：`/sillyspec:explore "想法"`
- 中断恢复：`/sillyspec:resume`
- 不知道下一步：`/sillyspec:continue`

## 命令列表

### 核心流程

| 命令 | 用途 |
|---|---|
| `/sillyspec:init` | 绿地项目：深度提问→需求→路线图 |
| `/sillyspec:scan` | 棕地项目：交互式引导扫描，生成代码库文档 |
| `/sillyspec:brainstorm` | 需求探索：支持原型图分析，大模块自动拆分 |
| `/sillyspec:propose` | 生成规范：proposal+design+tasks |
| `/sillyspec:plan` | 实现计划：精确文件路径+代码 |
| `/sillyspec:execute` | TDD 执行：子代理并行+两阶段审查 |
| `/sillyspec:verify` | 验证：对照规范+测试套件 |
| `/sillyspec:archive` | 归档：规范沉淀 |

### 辅助工具

| 命令 | 用途 |
|---|---|
| `/sillyspec:status` | 查看进度 |
| `/sillyspec:continue` | 自动下一步 |
| `/sillyspec:explore` | 自由思考：画图、讨论、调研 |
| `/sillyspec:quick` | 快速模式：跳过完整流程 |
| `/sillyspec:handoff` | 保存状态，下班走人 |
| `/sillyspec:resume` | 恢复工作：支持大模块阶段进度 |
| `/sillyspec:workspace` | 工作区管理：多项目子项目 |
| `/sillyspec:export` | 导出成功方案为可复用模板 |

## 可靠性保障

SillySpec 不仅仅是 prompt，还有硬校验：

- **锚定确认** — propose/plan/execute/verify 执行前必须逐个确认读过规范文件
- **Hard Gate 自检** — 关键命令生成文件后强制自检格式，不通过则修正
- **校验脚本** — shell 脚本可自动化验证 AI 输出（validate-proposal/plan/scan/all）
- **框架隐形规则扫描** — scan 阶段自动检测多租户/逻辑删除/审计字段/实体基类，写入 CONVENTIONS.md
- **实体继承规范扫描** — 新建表时必须包含基类所有字段，防止 Unknown column
- **归档确认** — archive 操作前展示内容等待用户确认

## 防幻觉机制

| 环节 | 机制 |
|---|---|
| scan | 强制扫描数据库 schema + 框架隐形规则 + 实体基类字段 |
| brainstorm | 必须读 ARCHITECTURE.md 数据模型，支持原型图分析 |
| execute | 写代码前强制读现有源码，禁止编造方法调用 |
| 全流程 | shell 校验脚本兜底 |

## 目录结构

```
sillyspec/
├── cli/                              # Node.js CLI（npx sillyspec）
│   ├── bin/sillyspec.js              # 入口
│   ├── src/
│   │   ├── index.js                  # status/next/check/init 命令
│   │   └── init.js                   # init 逻辑 + 工具适配器
│   └── templates/                    # 内置命令模板
├── commands/sillyspec/              # slash commands（Claude Code）
├── templates/                       # 纯 prompt 模板（工具无关）
├── adapters/
│   └── adapters.sh                  # 多工具格式转换函数（bash 版，已废弃）
├── scripts/
│   ├── init.sh                      # init 入口（转发给 CLI）
│   ├── validate-proposal.sh         # 校验 propose 输出
│   ├── validate-plan.sh             # 校验 plan 输出
│   ├── validate-scan.sh             # 校验 scan 输出
│   └── validate-all.sh              # 综合校验
├── 操作文档.md                       # 详细操作指南
└── README.md
```

## 致谢

- [Superpowers](https://github.com/obra/superpowers) — 工程纪律
- [OpenSpec](https://github.com/Fission-AI/OpenSpec) — 需求管理
- [GSD](https://github.com/gsd-build/get-shit-done) — 上下文工程

## License

MIT