# EPEE Skill Registry

> 本文件由 EPEE Skill Orchestrator 维护，记录所有已实现 Skill 的摘要信息。
> 每次创建/修改 Skill 后必须同步更新（参见 AGENTS.md 中的"Registry 同步"章节）。

## 条目格式说明

每个条目包含以下字段：
- **类型**：项目级 / 个人级 / 基础设施
- **能力**：1 句话核心能力描述
- **触发场景**：逗号分隔的关键词/短语，用于与任务特征匹配
- **输出**：该 Skill 的产出物
- **路径**：SKILL.md 的相对路径（相对于 `.opencode/skills/`）
- **备注**（可选）：特殊说明

---

## 已注册 Skill

### opencode-init
- **类型**: 基础设施
- **能力**: 把从模板 clone 或复制过来的 .opencode/ 重置为新项目的干净起点——清理源项目的项目专用数据，重建 registry，交互式生成 .gitignore，最后写入 `.opencode/.init-done` sentinel
- **触发场景**: 首次会话自动触发（.opencode/.init-done 缺失时由 AGENTS.md 引导）；关键词："初始化opencode"、"opencode init"、"重置 opencode"、"reset opencode"、"补 gitignore"、"生成 gitignore"、"gitignore 模板"
- **输出**: 清理后的 `.opencode/` 结构（规范清单完整、数据文件为模板、registry 仅含通用条目）、项目根 `.gitignore`（可选）、`.opencode/.init-done` sentinel
- **路径**: .opencode/skills/opencode-init/SKILL.md
- **备注**: 首次通过 sentinel 自动触发一次，之后仅关键词手动触发；破坏性操作必须 dry-run；设计为幂等，重复运行无害；阶段 7 失败时不写 sentinel 保证可恢复

### deferred-decisions
- **类型**: 基础设施
- **能力**: 记录和追踪延期的技术方案/决策，在关联任务出现时主动提醒
- **触发场景**: "以后再做"、"先不做"、"defer"、延期方案管理、延期回顾
- **输出**: .opencode/data/deferred/registry.md 条目
- **路径**: .opencode/skills/deferred-decisions/SKILL.md
- **备注**: 不参与任务分流匹配，仅作为 Orchestrator 的下游工具

### dev-changelog
- **类型**: 基础设施
- **能力**: 三层开发进程记录系统，Agent 完成代码改动后自动记录，提供一句话概要到完整日志的多级上下文
- **触发场景**: "开发日志"、"changelog"、"最近改了什么"、"回顾改动"、"查看开发记录"、代码改动后自动写入
- **输出**: .opencode/data/changelog/ 下的 changelog-full.md、changelog-recent.md、changelog-headlines.md
- **路径**: .opencode/skills/dev-changelog/SKILL.md

### pitfall-journal
- **类型**: 基础设施
- **能力**: 记录开发中踩过的坑（非显而易见的问题），在遇到同类问题时自动检索匹配已有经验
- **触发场景**: debug 完成后、"踩坑"、"之前遇到过"、"坑"、进入 Debug mode、同类错误反复出现
- **输出**: .opencode/data/pitfalls/pitfalls.md 条目
- **路径**: .opencode/skills/pitfall-journal/SKILL.md

### problem-distillery
- **类型**: 基础设施
- **能力**: 追踪反复出现的顽固问题，记录解决过程和弯路，定期蒸馏精炼方法论，经实践验证后自动升级为新会话常规注入
- **触发场景**: "还有问题"、"没解决"、"还是一样"、"又出现了"、"试了好多次"、"反复出现"、Agent 意识到同一问题尝试 2 次以上未解决、"蒸馏"、"总结经验"
- **输出**: .opencode/data/distillery/ 下的 problems.md、insights.md、golden-rules.md
- **路径**: .opencode/skills/problem-distillery/SKILL.md

### profile-memory
- **类型**: 个人级
- **能力**: 在对话中被动检测用户个人特质和项目信息，经确认后持久化为精简画像和详细日志
- **触发场景**: "画像"、"profile"、"我的偏好"、"查看画像"、"项目信息"、"查看项目画像"、用户主动管理画像
- **输出**: .opencode/data/profile/user-profile.md、.opencode/data/profile/project-profile.md 及对应 log 文件
- **路径**: .opencode/skills/profile-memory/SKILL.md

### epee-orchestrator
- **类型**: 基础设施
- **能力**: 元层调度系统，检测任务是否可由已有 Skill 处理并分流，或发现 Skill 缺口并引导创建新 Skill；同时负责 Skill Registry 维护
- **触发场景**: 手动配置密集、重复模式明确、手工指引过长的任务、Skill 缺口发现、Registry 同步维护
- **输出**: 分流决策（调用已有 Skill / 创建新 Skill）、.opencode/skills/epee-orchestrator/registry.md 维护
- **路径**: .opencode/skills/epee-orchestrator/SKILL.md
- **备注**: 元层 Skill，自身注册以便其他 Agent 了解调度能力的可用性

### spec-docs
- **类型**: 基础设施
- **能力**: 规范文档全生命周期管理 — 执行前检查是否需要创建/更新文档，周期审查文档与 changelog/代码的一致性（遗漏、陈旧、互斥检测），写入/更新规范文档
- **触发场景**: "架构"、"重构"、"设计方案"、"交互规范"、"编码规范"、"审查文档"、"review docs"、"检查规范一致性"、"参考分析"、"竞品拆解"、"反拆"、"GDD"、"设计参考"、周期自动审查（7天/30条changelog）
- **输出**: docs/ 下 architecture/conventions/specs/reference 子目录的规范文档、.opencode/data/spec-docs/state.json、审查报告
- **路径**: .opencode/skills/spec-docs/SKILL.md
- **备注**: 操作 B 具备 changelog 不可信假设与代码搜索 fallback 的互斥检测能力

### game-design
- **类型**: 项目级
- **能力**: 游戏设计全流程辅助系统 — 从创意概念到设计大纲，通过参考游戏分析（GDD 逆向 + 社群口碑）、3 轮 × 5 题初步问答、一致性审查、3+ 轮深度问答，最终产出包含 VISTA 框架的设计大纲
- **触发场景**: "我想做一个xxx游戏"、"设计一个xxx玩法"、"帮我设计游戏"、用户提出游戏创意时；仅在 `design` 阶段可用
- **输出**: `.opencode/phase/data/design/` 下的 state.json、concept.md、reference-analysis/*.md、qa-initial/*.md、qa-deep/*.md、design-outline.md、qa-quality-report.md
- **路径**: .opencode/skills/game-design/SKILL.md
- **备注**: 仅 `phases: ["design"]`；内建 Hallucination 三级防御（置信度标注+来源锚定+局限性声明）、一致性审查（5 维度矛盾检测）、不可逆决策标记、问答质量预防+反馈双循环、事务化状态管理；支持跨会话恢复