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

assets/api-blank.md

View on GitHub
# {{模块名}} 模块接口文档

> **模块说明**:{{模块功能描述,说明该模块管理的资源及支持的操作}}
>
> **Base Path**:所有接口均以 `/{{basePath}}` 为前缀。
>
> **认证**:{{描述认证方式,如:所有请求需在 Header 中携带 `Authorization: Bearer <token>`}}

---

## 认证 Header

<!-- 按项目实际认证方案填写;不需要则删除本节 -->

| Header 名 | 必填 | 说明 |
|---|---|---|
| `Authorization` | 是 | {{认证令牌说明}} |
| `{{headerName}}` | {{是/否}} | {{说明}} |

---

## 统一响应格式

<!-- 按项目实际响应结构填写;不需要则删除本节 -->

所有接口均返回统一的响应结构。

```json
{
  "{{字段名}}": "{{说明}}",
  "{{字段名}}": "{{说明}}"
}
```

| 字段 | 类型 | 说明 |
|---|---|---|
| `{{字段名}}` | {{类型}} | {{说明}} |

---

## 枚举值说明

<!-- 如无枚举值可删除本节;每组枚举单独建一个小节 -->

### {{enumName}} — {{枚举用途描述}}

| 枚举值 | 说明 |
|---|---|
| `ENUM_VALUE_1` | {{说明}} |
| `ENUM_VALUE_2` | {{说明}} |

---

## 接口列表

<!-- 
  按实际接口数量复制下方的「接口块」,每个接口一节。
  分组方式(按资源、按功能域等)根据项目自行决定。
  示例中提供了两种常见请求形式(Query 参数 / 请求体),按需保留其一。
-->

---

### 1. {{接口功能名}}

**`{{METHOD}} /{{path}}`**

{{接口详细说明,描述业务含义、前置条件、关键约束等。}}

#### 请求参数

<!-- Query 参数形式(GET/DELETE 常用)—— 不需要则删除 -->

| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `{{param}}` | string | **是** | {{说明}} |
| `{{param}}` | string | 否 | {{说明}} |

<!-- 请求体形式(POST/PUT/PATCH 常用)—— 不需要则删除 -->

```json
{
  "{{field}}": "{{value}}",
  "{{field}}": "{{value}}"
}
```

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `{{field}}` | string | **是** | {{说明}} |
| `{{field}}` | string | 否 | {{说明}} |

#### 响应

```json
{
  "{{field}}": "{{value}}"
}
```

| 字段 | 类型 | 说明 |
|---|---|---|
| `{{field}}` | {{类型}} | {{说明}} |

#### 错误情况

<!-- 只列出该接口特有的错误;通用错误(认证失败、系统异常等)已在统一响应格式中说明 -->

| 错误码 | 说明 | 触发条件 |
|---|---|---|
| `{{code}}` | {{message}} | {{触发条件}} |

---

### 2. {{接口功能名}}

<!-- 复制上方接口块继续填写 -->

---

## 接口汇总

| # | 方法 | 路径 | 说明 |
|---|---|---|---|
| 1 | {{METHOD}} | `/{{path}}` | {{说明}} |
| 2 | {{METHOD}} | `/{{path}}` | {{说明}} |
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