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 |
error-handling.md
View on GitHub# 异常处理 — 用户提示机制
在整个流程执行过程中,遇到以下情况时**必须暂停并提示用户**,不自行决定处理方式:
## 网络与 API 异常
| 异常类型 | 提示内容 |
|---|---|
| Tool 调用连续失败 ≥ 3 次 | `⚠️ 工具调用连续失败 <N> 次:<错误摘要>。建议检查网络或 API 状态后继续。` |
| API 返回 429/503/504 | `⚠️ API 服务暂不可用(<状态码>)。建议稍后重试或检查 API 配额。` |
| API 认证失败(403/401) | `⚠️ API 认证失败。请检查 token 或认证配置。` |
## 环境异常
| 异常类型 | 提示内容 |
|---|---|
| 构建命令执行失败 ≥ 2 次 | `⚠️ 构建连续失败。请检查构建环境配置,或手动验证后告知我继续。` |
| 应用启动超时或失败 | `⚠️ 应用启动异常。请检查启动命令或环境状态,手动确认后告知我继续。` |
| 数据库连接失败 | `⚠️ 数据库连接失败。请检查数据库状态和连接配置。` |
**处理原则:** 遇到异常后停止、报告、等待用户指示。不在用户不知情的情况下自动重试或绕过问题。
**恢复规则:** 用户确认环境或问题已修复后,回到失败前的步骤重新执行(如 B.4 构建失败 → 用户修复环境 → 重新运行 B.4;C.1 启动失败 → 用户确认应用已启动 → 继续 C.2)。
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 |