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 |
init.md
View on GitHub# 初始化 — 创建项目索引文件
`docs/plans/PROJECT.md` 不存在,执行以下步骤,完成后返回 SKILL.md 进入 Step 0。
1. 读取 `skills/spec-first/assets/project-index.md` 作为骨架,写入 `docs/plans/PROJECT.md`。若该路径读取失败(CWD 不在项目根目录时常见),直接使用以下最小骨架内联写入:
```markdown
# 项目索引
> 本文件记录项目功能模块清单与对应技术方案路径。
## 项目概览
- **项目定位**:
- **技术栈**:
- **全局 API 约定**:
## 功能清单
| 一级模块 | 二级模块 | 技术方案 |
|---|---|---|
| — | — | — |
```
2. 输出提示:
```
⚠️ 未找到 docs/plans/PROJECT.md,已从模板创建。
请填写以下基本信息(可跳过,后续手动维护):
· 项目定位(1-3 句话)
· 技术栈(语言、框架、数据库)
· 全局 API 约定(认证方式、统一响应结构)
填写完成后回复"继续",或直接回复"跳过"进入开发流程。
```
3. 等待用户回复:
- 用户提供信息 → 将其填入 `docs/plans/PROJECT.md` 对应章节并保存,然后继续
- 用户回复"跳过" → 直接继续
4. 初始化完成,返回 SKILL.md Step 0
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 |