5.3 KiB
5.3 KiB
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-donesentinel - 触发场景: 首次会话自动触发(.opencode/.init-done 缺失时由 AGENTS.md 引导);关键词:"初始化opencode"、"opencode init"、"重置 opencode"、"reset opencode"、"补 gitignore"、"生成 gitignore"、"gitignore 模板"
- 输出: 清理后的
.opencode/结构(规范清单完整、数据文件为模板、registry 仅含通用条目)、项目根.gitignore(可选)、.opencode/.init-donesentinel - 路径: .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"、"检查规范一致性"、周期自动审查(7天/30条changelog)
- 输出: docs/ 下 architecture/conventions/specs 子目录的规范文档、.opencode/data/spec-docs/state.json、审查报告
- 路径: .opencode/skills/spec-docs/SKILL.md
- 备注: 操作 B 具备 changelog 不可信假设与代码搜索 fallback 的互斥检测能力