Agent Skills
Wow Agent Skills 把框架特有的工作流、架构不变量、安全边界和完成证据组织成四个可复用 Skill。它们不复制 API 文档；注解参数、配置默认值、DSL 方法和生成契约必须在当前 checkout 或精确目标 tag 中重新确认。skills/README.md
| 入口 | 用途 |
|---|---|
Wow skills/ | Skill 内容、references、assets、evals 与插件源元数据 |
| Ahoo Skills 站点 | 插件目录、安装命令与分发说明 |
| Ahoo-Wang/skills | Codex 与 Claude Code 的聚合市场 |
| Agent Skills 规范 | SKILL.md 格式与渐进式披露模型 |
Wow 仓库拥有 Skill 内容；Ahoo Skills Hub 定期同步、校验并生成 ahoo-wow-skills 插件。不要直接修改聚合仓库中的生成副本。skills/README.md
四个 Primary Skills
客户端按用户的主要交付结果选择一个 Primary Skill，而不是按涉及的组件名选择。选定后，该 Skill 负责整个任务，不再切换到另一个 Wow Skill。skills/README.md
| Skill | 何时使用 | 完整生命周期 |
|---|---|---|
wow-develop | 设计、实现、测试、重构或解释 Wow 行为/API | 只读：Frame → Discover → Model → Prove facts → Verify → Report；授权变更：Frame → Discover → Model → Prove RED → Change → Verify → Report |
wow-review | 输出 findings、质量判断、合并准备度，或执行 review-and-fix | Scope → Context → Findings → 授权修复 → Post-fix review |
wow-debug | 复现和定位已有失败，或执行 diagnose-and-fix | Capture → Reproduce → Locate → Hypothesize → Test → Fix/Conclude |
wow-migrate | 破坏性版本迁移，或任意起始版本的存储/数据格式切换 | Baseline → Target → Matrix，之后仅执行已明确授权的适配、数据、验证与切换阶段 |
对应源文件：wow-develop、wow-review、wow-debug、wow-migrate。
选择顺序
- 跨主版本、同主版本 source/config 破坏性变化，或任意版本起点的存储/数据切换与回滚是主问题：
wow-migrate。 - 已有失败、hang、错误状态或 reproducer，目标是根因：
wow-debug。 - 目标是 findings、批准或合并准备度：
wow-review。 - 目标是设计、修改、测试或解释 Wow：
wow-develop。 - 纯 Kotlin/Gradle、dashboard 或不涉及框架语义的文档任务：不激活。
review-and-fix 始终留在 wow-review；diagnose-and-fix 始终留在 wow-debug。这样授权状态、证据和 diff 基线不会在 Skill 切换时丢失。
渐进式加载
每个 SKILL.md 只保存核心流程和选择规则，具体领域材料按需加载：开发 Skill 的 reference 表。
| 任务 | 首个 reference |
|---|---|
| Aggregate、command、event、sourcing | aggregate-sourcing.md |
| Saga、Projection、EventProcessor | saga-processors.md |
| CommandGateway、wait、HTTP command route | command-delivery.md |
| Query DSL 与 read model | query-read-model.md |
| Starter、storage、bus | starter-storage.md |
| Runtime lifecycle | runtime-lifecycle.md |
| PrepareKey 唯一性与预留 | prepare-key.md |
references 只保存稳定决策、源码发现方法和验证边界。完整注解参数、测试 DSL 方法表、配置键、默认值和后端枚举应直接从目标版本源码发现。skills/README.md
安装
Codex
codex plugin marketplace add Ahoo-Wang/skills --ref main
codex plugin add ahoo-wow-skills@ahoo-skillsClaude Code
/plugin marketplace add https://github.com/Ahoo-Wang/skills
/plugin install ahoo-wow-skills安装命令和当前发布状态以 Ahoo Skills 中文站点 为准。插件更新后，使用客户端的刷新机制或新任务确认四个 Skill 已被发现。
四 Skill 架构是有意的破坏性重写：不分发旧名称或兼容别名。既有安装需要在发布后刷新或重新安装插件。
使用方式
请求至少应说明目标、范围、授权模式和完成证据：
以下示例均指使用 Wow 的下游应用；不要把 Wow 框架仓库或其模块作为这些 Skills 的目标。
| 信息 | 示例 |
|---|---|
| 目标 | “为 Order 增加取消能力并补测试” |
| 范围 | “只修改下游 order-domain，保持公开 API 兼容” |
| 模式 | “只 review，不修改”或“定位并修复” |
| 验证 | “运行 :order-domain:test 并报告准确结果” |
验证与维护
维护者运行：
python3 -S scripts/validate_wow_skills.py
python3 -S -m unittest scripts/test_validate_wow_skills.py轻量 validator 只使用 Python 标准库，校验 Skill metadata、openai.yaml、显式插件清单、本地资源引用的存在性与路径边界，以及 activation/behavior JSONL 的 ID 和 Skill 引用。skills/README.md
结构校验不会证明自然语言触发或行为正确。activation/behavior 用例是可由标准 Agent eval 工具或人工前向评估消费的测试数据：在全新任务中只提供 prompt 与必要 fixture，对 Agent 隐藏期望项，再根据真实 diff、命令结果和最终证据评分。仓库不维护专属 eval runner；安装后的 Skill 也不依赖这些维护脚本。
相关页面
| 页面 | 关系 |
|---|---|
| 快速上手 | 建立可运行的 Wow 应用 |
| 聚合建模 | wow-develop 的 Aggregate 建模背景 |
| 测试套件 | 当前 Aggregate/Saga 测试 API |
| 故障排查 | wow-debug 的运行与配置排障背景 |
| Wow v6 迁移到 v8 | wow-migrate 的框架迁移专题 |