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/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 -->
...
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 |