zzusp/doc-first-dev / skills/spec-multi
spec-multi
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.8 KB |
| assets/multi-spec-blank.md | markdown | 1.3 KB |
| assets/services-index-blank.md | markdown | 559 B |
| error-handling.md | markdown | 1.6 KB |
| evals/eval-01-cross-service-feature.md | markdown | 2.5 KB |
| evals/eval-02-interface-drift.md | markdown | 1.8 KB |
| evals/eval-03-partial-service-change.md | markdown | 2.2 KB |
| init.md | markdown | 1.9 KB |
| phase-a.md | markdown | 4.3 KB |
| phase-b.md | markdown | 2.6 KB |
| phase-c.md | markdown | 6.1 KB |
| phase-d.md | markdown | 2.9 KB |
| step0.md | markdown | 1.2 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.3 构建失败 → 用户修复环境 → 重新运行 B.3;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 |