version init

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

@@ -0,0 +1,123 @@
+---
+name: epee-orchestrator
+description: >-
+  EPEE Skill Orchestrator：元层调度系统。检测任务是否可由已有 Skill 处理并分流，
+  或发现 Skill 缺口并引导创建新 Skill。当 Agent 遇到手动配置密集、重复模式明确、
+  手工指引过长的任务时触发。也用于 Skill Registry 的维护和同步。
+---
+
+# EPEE Skill Orchestrator
+
+元层调度系统，负责 Skill 分流、缺口发现和 Registry 维护。
+
+## 操作 A：Skill 分流（匹配已有 Skill）
+
+### 流程
+
+```
+1. 读取 registry.md 获取所有已注册 Skill 的摘要
+2. 将当前任务特征与每个 Skill 的"触发场景"关键词匹配
+3. 如果匹配到：
+   a. 告知用户"此任务可以通过 [Skill名] 高效完成"
+   b. 简述该 Skill 的能力及与当前任务的契合点
+   c. 用户确认后，读取并激活对应 Skill 的 SKILL.md
+```
+
+### 匹配规则
+
+- 优先匹配触发场景关键词与当前任务描述的交集
+- 如有多个 Skill 匹配，按相关度排序推荐，由用户选择
+- `deferred-decisions` 等标记为"基础设施"类型的 Skill 不参与任务分流匹配，
+  仅作为 Orchestrator 的下游工具使用
+
+## 操作 B：Skill 缺口发现 + 创建引导
+
+### 触发条件
+
+操作 A 未找到匹配的 Skill，且当前任务满足"Skill 创建价值判断标准"中至少 2 条。
+
+### 流程
+
+```
+1. 向用户提出建议：
+   "这类任务可以通过创建一个 [建议 Skill 名] 来自动化"
+2. 给出 1-3 句方案概要：
+   - 这个 Skill 会做什么
+   - 核心工作机制
+   - 预估能节省的重复劳动
+3. 询问用户选择：
+   a) "继续讨论并创建" → 进入创建流程
+   b) "以后再说" → 进入延期记录流程
+   c) "不需要" → 结束，正常执行当前任务
+```
+
+### a) 创建流程
+
+```
+1. 按 Skill 创建标准流程完成 Discovery → Design → Implementation → Verification
+2. 将以下上下文纳入考量：
+   - 触发创建的原始任务描述
+   - Orchestrator 的方案概要
+   - 建议的 Skill 名称
+3. 创建完成后，要求用户对新 Skill 进行实际测试
+4. 测试通过后，执行操作 C 同步 Registry
+```
+
+### b) 延期记录流程
+
+```
+1. 读取 deferred-decisions Skill（路径: .opencode/skills/deferred-decisions/SKILL.md）
+2. 按其"操作 A：记录延期方案"流程，将 Skill 创建建议记录为 deferred item
+3. tags 中包含 "skill-creation" 和相关领域标签
+4. context 中记录方案概要，便于未来回忆
+```
+
+## 操作 C：Registry 同步
+
+### 触发条件
+
+- 新 Skill 被创建后
+- 已有 Skill 的 SKILL.md 被实质性修改后（如能力范围变化、触发场景变化）
+
+### 流程
+
+```
+1. 读取目标 Skill 的 SKILL.md
+2. 从 frontmatter 提取 name 和 description
+3. 从正文提取核心能力和触发场景关键词
+4. 读取 registry.md
+5. 新增或更新对应条目，遵循 registry.md 中定义的条目格式
+6. 写回 registry.md
+```
+
+### 条目格式
+
+参见 [registry.md](registry.md) 中的条目结构。
+
+## Skill 创建价值判断标准
+
+当操作 A 无匹配时，Agent 使用以下标准评估是否建议创建新 Skill。
+满足 **2 条及以上** 即认为值得建议：
+
+1. **频次**：该类任务预计会出现 3 次以上
+2. **模式明确**：任务有明确的输入/输出模式（输入 X → 产出 Y）
+3. **步骤繁多**：手动操作步骤 >= 5 步，或涉及 >= 3 个文件的协调修改
+4. **易错**：存在容易出错的重复性操作（如 GUID 填写、格式对齐等）
+5. **可自动化**：可以通过生成 DSL / YAML / 配置文件来替代手动操作
+
+不满足标准时，Agent 正常执行任务，不提出创建建议。
+
+## 与其他系统的协作
+
+| 系统 | 关系 | 说明 |
+|------|------|------|
+| `deferred-decisions` Skill | 下游工具 | 操作 B 延期记录的执行者 |
+| AGENTS.md | 规则来源 | Skill 自迭代和 Registry 同步的强制要求由 AGENTS.md 定义 |
+
+## 自迭代日志
+
+本节记录使用本 Skill 过程中发现的必要检查项。
+
+### 已知必要检查
+
+1. **收尾动作级联遗漏** — 当 Agent 遗漏了一个收尾动作（如 changelog 写入）后，后续的收尾动作（自迭代、Registry 同步）也会被一并遗漏，因为它们都在同一个"收尾阶段"。AGENTS.md 中的 Checklist 化设计可以打断这种级联——每项独立检查，不依赖前一项的执行记忆。

.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 了解调度能力的可用性