zzusp/doc-first-dev / skills/spec-multi
spec-multi
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.8 KB |
| assets/multi-spec-blank.md | markdown | 1.3 KB |
| assets/services-index-blank.md | markdown | 559 B |
| error-handling.md | markdown | 1.6 KB |
| evals/eval-01-cross-service-feature.md | markdown | 2.5 KB |
| evals/eval-02-interface-drift.md | markdown | 1.8 KB |
| evals/eval-03-partial-service-change.md | markdown | 2.2 KB |
| init.md | markdown | 1.9 KB |
| phase-a.md | markdown | 4.3 KB |
| phase-b.md | markdown | 2.6 KB |
| phase-c.md | markdown | 6.1 KB |
| phase-d.md | markdown | 2.9 KB |
| step0.md | markdown | 1.2 KB |
init.md
View on GitHub# init — 多服务项目初始化
首次使用 `/spec-multi` 且 `docs/plans/SERVICES.md` 不存在时执行。
## 步骤
### 1. 扫描子目录识别服务
扫描 workspace root 下各子目录,识别含以下特征文件的目录作为候选服务:
| 特征文件 | 推断技术栈 |
|---|---|
| `package.json` + `next.config.*` | Next.js |
| `package.json` + `vite.config.*` | React/Vue/Vite |
| `package.json`(无前端框架配置) | Node.js |
| `go.mod` | Golang |
| `requirements.txt` / `pyproject.toml` / `uv.lock` | Python |
| `pom.xml` | Java/Maven |
| `build.gradle` | Java/Gradle |
| `Cargo.toml` | Rust |
跳过:`.git`、`node_modules`、`dist`、`build`、`__pycache__`、`.venv` 等构建/依赖目录。
### 2. 展示识别结果,逐项确认
列出识别到的候选服务,询问用户:
```
识别到以下目录可能是服务,请确认或修改:
1. ./backend — Node.js(package.json)— 是否作为服务?[Y/n] 服务名?端口?启动命令?
2. ./frontend — React/Vite(vite.config.ts)— ...
3. ./data-service — Python(requirements.txt)— ...
```
对每个确认的服务收集:
- **服务名**(用于 `[服务名]` 标签,建议小写+连字符,如 `backend`、`data-service`)
- **启动命令**(如 `npm run dev`、`uvicorn main:app --reload`)
- **监听端口**
### 3. 确认服务间依赖关系
询问:"哪些服务依赖其他服务?(用于确定启动顺序和开发顺序)"
示例回答:`frontend 依赖 backend,backend 依赖 data-service`
### 4. 生成 SERVICES.md
根据收集信息,从 [assets/services-index-blank.md](assets/services-index-blank.md) 生成 `docs/plans/SERVICES.md`。
创建 `docs/plans/requirements/` 目录(若不存在)用于存放需求文档。
### 5. 完成
告知用户 SERVICES.md 已生成,返回 [step0.md](step0.md) 继续接收需求。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |