用途:该技能聚焦有意设计的错误处理策略,核心理念是“错误是数据,而不只是异常”,用于构建有韧性的应用。
主要能力:提供快速决策指引,按场景选择模式——类型化错误类别用自定义错误类;显式处理(不用 throw)用 Result/Either 类型;React 组件崩溃用错误边界;API 错误响应用结构化 API 错误;网络请求失败用带退避的重试;下游服务不可靠用熔断器。
关键原则:可调试(丰富上下文、堆栈跟踪、关联 ID)、可恢复(重试、降级、熔断)、对用户友好(清晰消息、恢复指引、不泄露内部信息)、一致性(所有 API 端点错误形状一致)。
快速开始清单:定义含 code 与 context 的基础 AppError 类;创建领域特定错误子类;实现一致的 API 错误响应形状;在应用、路由、组件层级添加错误边界;设置带脱敏的错误追踪(Sentry)。
参考文档:error-patterns.md(自定义错误、Result 类型、错误层级)、react-errors.md(错误边界、Suspense)、api-errors.md(HTTP 错误、响应形状、状态码)、recovery-patterns.md(重试、熔断、降级)、overview.md(错误类型、Result 模式、用户消息、追踪、反模式)、anti-rationalization.md(铁律、常见合理化、红旗 STOP 清单)、tdd-patterns.md(错误路径、重试逻辑、边界的测试先行模式)、review-checklist.md(类、消息、恢复、追踪的评审清单)。
运行时说明:在 Claude Code 中通过 Task 工具派发相关 agent,subagent_type 为 "pokayokay:yokay-<name>"(如 yokay-implementer、yokay-fixer、yokay-spec-reviewer 或 yokay-quality-reviewer)。在 Codex 中无子代理派发,需内联执行角色,读取对应 agents/yokay-<name>.md,并在当前会话直接遵循其行为默认值、关键规则与输出契约。
限制:资料未提供具体代码示例、收费或平台支持等细节。