Skip to content

zzusp/doc-first-dev / skills/spec-multi

spec-multi

Verified

FileKindSize
SKILL.mdskill md1.8 KB
assets/multi-spec-blank.mdmarkdown1.3 KB
assets/services-index-blank.mdmarkdown559 B
error-handling.mdmarkdown1.6 KB
evals/eval-01-cross-service-feature.mdmarkdown2.5 KB
evals/eval-02-interface-drift.mdmarkdown1.8 KB
evals/eval-03-partial-service-change.mdmarkdown2.2 KB
init.mdmarkdown1.9 KB
phase-a.mdmarkdown4.3 KB
phase-b.mdmarkdown2.6 KB
phase-c.mdmarkdown6.1 KB
phase-d.mdmarkdown2.9 KB
step0.mdmarkdown1.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)。
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