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

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)。
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