Skip to content

zzusp/doc-first-dev / skills/spec-first

spec-first

Verified

管理项目模块的完整开发周期:需求分析→更新技术方案→spec确认→开发→验收→收尾。适用于功能新增、Bug修复、需求变更、接口调整、重构、字段增删等涉及代码变更的任务;项目下有或无 spec 文档均可触发,无需用户明确指定流程。

FileKindSize
SKILL.mdskill md3.9 KB
assets/api-blank.mdmarkdown2.7 KB
assets/claude-md-snippet.mdmarkdown1.8 KB
assets/project-index.mdmarkdown1.7 KB
assets/tech-spec-blank.mdmarkdown4.8 KB
error-handling.mdmarkdown1.4 KB
evals/eval-01-new-feature.mdmarkdown1.8 KB
evals/eval-02-spec-code-mismatch.mdmarkdown1.3 KB
evals/eval-03-init-flow.mdmarkdown1.2 KB
init.mdmarkdown1.2 KB
phase-a.mdmarkdown10.5 KB
phase-b.mdmarkdown4.9 KB
phase-c.mdmarkdown6.8 KB
phase-d.mdmarkdown5.3 KB
step0.mdmarkdown3.9 KB

evals/eval-03-init-flow.md

View on GitHub
# Eval 03 — 首次运行,无 PROJECT.md(初始化流程)

## 场景描述

项目首次接入 spec-first,docs/plans/PROJECT.md 不存在,触发初始化分支。

## 输入

```json
{
  "skills": ["spec-first"],
  "query": "帮我给用户模块加一个邮箱登录接口",
  "context": "项目目录下无 docs/plans/ 目录,也无任何 spec 文件"
}
```

## 预期行为

- [ ] 前置检查:检测到 docs/plans/PROJECT.md 不存在
- [ ] 读取 init.md,从 assets/project-index.md 模板创建 docs/plans/PROJECT.md
- [ ] 输出警告提示,询问用户填写项目基本信息(项目定位、技术栈、API 约定)
- [ ] 等待用户回复(提供信息或"跳过")
- [ ] 填入用户提供的信息后保存,返回 SKILL.md Step 0
- [ ] Step 0:因 docs/plans/ 下此时只有 PROJECT.md(无模块 spec),询问用户是否新建模块 spec
- [ ] 用户确认后,从 assets/tech-spec-blank.md 模板创建用户模块 spec
- [ ] 进入 Phase A 分析邮箱登录接口需求

## 不应出现的行为

- 跳过初始化直接进入 Step 0 或 Phase A
- 创建 PROJECT.md 后不提示用户填写信息直接继续
- 用户说"跳过"时仍等待信息输入
- 初始化完成后忘记返回 Step 0(直接终止流程)
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall