mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-09 02:43:29 +08:00
1d0f64a14d
Add complete openclaw-persona-forge skill with all supporting files: - SKILL.md with community origin - gacha.py and gacha.sh for random soul generation - Reference docs for avatar style, boundary rules, error handling, identity tension, naming system, and output template Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.1 KiB
2.1 KiB
错误处理与降级策略
设计理念
任何错误都不应中断用户的创造流程。降级，不中断。
错误分类与降级矩阵
类型 A：环境缺失
| 错误场景 | 检测方式 | 降级策略 | 告知用户 |
|---|---|---|---|
| Python 3 不可用 | python3 --version 失败 |
跳过 gacha.py，从 10 类预设方向中随机选择 | "抽卡引擎需要 Python 3，已改用内置随机选择" |
类型 B：可选依赖不可用
| 错误场景 | 检测方式 | 降级策略 | 告知用户 |
|---|---|---|---|
| baoyu-image-gen skill 未安装 | 检查 skill 是否存在 | 输出完整提示词文本 + 手动生图平台说明 | "未检测到 baoyu-image-gen skill，已输出提示词供手动使用" |
| baoyu-image-gen 调用失败 | skill 返回错误 | 重试 1 次，仍失败则输出提示词文本 | "生图失败，已输出提示词供手动使用" |
类型 C：运行时异常
| 错误场景 | 降级策略 | 告知用户 |
|---|---|---|
| gacha.py 输出格式异常 | 从 10 类预设方向中随机选择 | "抽卡结果解析失败，已改用内置随机" |
| 任何未预期错误 | 记录错误信息，跳过该步骤，继续主流程 | "遇到了一个问题：[错误简述]。已跳过继续" |
错误信息统一格式
> ⚠️ **[步骤名] 已降级**
> 原因：[发生了什么]
> 影响：[什么功能受限]
> 替代：[正在用什么兜底]
> 修复：[怎么恢复完整功能]
示例：
> ⚠️ **头像生成已降级**
> 原因：未检测到 baoyu-image-gen skill
> 影响：无法自动生成头像图片
> 替代：已输出完整提示词，可复制到 Gemini / ChatGPT 手动生成
> 修复：安装 baoyu-image-gen skill → https://github.com/JimLiu/baoyu-skills
关键原则
- 文本方案是核心价值，头像是锦上添花——辅助功能失败永不中断主流程
- 降级信息要可操作——不只说"出错了"，要说"怎么修"
- 一次降级不影响后续步骤——Step 5 降级了，Step 6 照常输出