version init

.opencode/skills/epee-orchestrator/registry.md

@@ -0,0 +1,70 @@
+# 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 了解调度能力的可用性