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/project-index.md

View on GitHub
# PROJECT.md — <项目名称>

> 项目级索引,供团队成员和 AI agent 快速建立全局认知。
> 由 `/spec-first` 前置检查自动生成,后续手动维护。
> `功能清单总表` 是 `/spec-first` Step 0.3 文档匹配的依据,请保持更新。
> 每次 `/spec-first` Phase D 收尾时,会自动更新对应模块行的技术方案链接。

---

## 项目定位

<!-- 1-3 句话:这个项目是什么,服务什么用户,解决什么问题 -->

...

## 功能清单总表

> 「—」= 无独立技术方案文档,功能细节见源码。新增 spec 文档后在对应行补充链接。

| 一级模块 | 二级模块 | 功能点 | 技术方案 |
|---|---|---|---|
| **1. <模块名>** | <子模块> | <功能描述> | [<spec标题>](<path/to/spec.md>) |
| | <子模块> | <功能描述> | — |
| **2. <模块名>** | <子模块> | <功能描述> | — |

---

## 技术栈

| 层次 | 技术选型 |
|---|---|
| 语言/运行时 | <e.g. Java 17 / Node.js 20 / Python 3.11> |
| 框架 | <e.g. Spring Boot 3.x / Express / FastAPI> |
| 数据库 | <e.g. PostgreSQL 15 / MySQL 8> |
| 缓存 | <e.g. Redis 7 / 无> |
| 构建工具 | <e.g. Maven 3.9 / npm / pip> |

---

## 核心约束

<!-- 影响所有模块的全局约束,写这里省去每份 spec 重复说明 -->

- ...

---

## 全局 API 约定

### 认证

<!-- e.g. Bearer Token,登录接口路径,token 有效期 -->

...

### 统一响应结构

```json
{
  "code": 0,
  "msg": "success",
  "data": {}
}
```

### 错误码

| code | 含义 |
|---|---|
| 0 | 成功 |
| 401 | 未登录 |
| 403 | 无权限 |
| \<xxx\> | \<含义\> |

### 分页约定

<!-- e.g. POST body 传 pageNum/pageSize,响应返回 total/records -->

...
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: 198kUpdated 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