zzusp/doc-first-dev / skills/spec-first
spec-first
Verified管理项目模块的完整开发周期:需求分析→更新技术方案→spec确认→开发→验收→收尾。适用于功能新增、Bug修复、需求变更、接口调整、重构、字段增删等涉及代码变更的任务;项目下有或无 spec 文档均可触发,无需用户明确指定流程。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.9 KB |
| assets/api-blank.md | markdown | 2.7 KB |
| assets/claude-md-snippet.md | markdown | 1.8 KB |
| assets/project-index.md | markdown | 1.7 KB |
| assets/tech-spec-blank.md | markdown | 4.8 KB |
| error-handling.md | markdown | 1.4 KB |
| evals/eval-01-new-feature.md | markdown | 1.8 KB |
| evals/eval-02-spec-code-mismatch.md | markdown | 1.3 KB |
| evals/eval-03-init-flow.md | markdown | 1.2 KB |
| init.md | markdown | 1.2 KB |
| phase-a.md | markdown | 10.5 KB |
| phase-b.md | markdown | 4.9 KB |
| phase-c.md | markdown | 6.8 KB |
| phase-d.md | markdown | 5.3 KB |
| step0.md | markdown | 3.9 KB |
assets/claude-md-snippet.md
View on GitHub# CLAUDE.md 片段 — 粘贴到项目 CLAUDE.md 中
将以下内容追加到项目的 CLAUDE.md,并替换尖括号中的占位符。
---
## 构建命令
```bash
# 填写项目的构建/编译/类型检查命令
# /spec-first skill 的 Phase B.4 构建验证会引用此处
# Java/Maven 示例:
# JAVA_HOME="/path/to/jdk" mvn compile -q
# Node.js 示例:
# npm run build
# npm run typecheck
# Python 示例:
# mypy src/
# Go 示例:
# go build ./...
```
## 启动与认证
> /spec-first skill 的 Phase C.1 验收准备会引用此处。
### 启动应用
```bash
# 填写本地启动命令
# 示例:
# .\scripts\start-app.ps1
# docker compose up -d
# npm run dev
```
预期启动时间:`<X 秒 / X 分钟>`
启动日志位置:`<日志路径,如有>`
### 获取认证 Token
```bash
# 填写获取测试用 token 的命令
# 示例:
# LOGIN_PASSWORD='your-password' python scripts/login.py
# curl -X POST http://localhost:8080/auth/login \
# -H "Content-Type: application/json" \
# -d '{"username":"admin","password":"xxx"}'
```
### 必要的请求头
验收时需要保存以下 Header(从登录响应中提取):
- `Authorization`:Bearer token
- `<其他项目特定 Header>`
## 文档驱动开发规则
本项目启用文档先行(doc-first)开发规范,由 `/spec-first` skill 驱动:
1. 任何需求变更、功能新增、Bug 修复,必须先运行 `/spec-first <需求描述>` 更新技术方案,再开始编码。
2. 技术方案文档位于 `docs/plans/`,模块索引见 `docs/plans/PROJECT.md`。
3. spec 文档记录**当前状态**,不记录变更历史——直接改写旧内容。
4. spec 更新和代码变更放在同一次 git commit 中。
5. spec 与实际代码不一致时,停止并向用户说明差异,等确认后再继续。
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: 198k | 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 |