Agent Skills
本页回答：下游 Wow 任务应使用哪个 Primary Skill，以及完成如何被证明？
Wow 仓库拥有 Skill 源码和验证夹具；分发仓库与客户端拥有安装和发现流程。Skills 提供工作流、架构不变量、授权边界和证据门禁，不替代目标版本的 API、配置或生成契约。
V9 是当前维护基线和默认术语。三个日常 Skill 仍可处理 V8 下游任务，但必须先从目标构建与解析依赖确认实际 Wow 版本；V8 到 V9 的旧类型、配置与行为映射仅由 wow-migrate 保存。无法确认版本时，任何版本专属结论都必须标记为未验证。
选择一个 Primary Skill
按用户要求的主要交付结果选择一次，并由该 Skill 负责完整任务：
| Skill | 选择条件 | 不选择的情况 |
|---|---|---|
wow-migrate | 跨主版本、已知破坏性 source/config/generated/runtime 变化，或 Wow 管理的存储/历史数据切换 | 无历史转换的首次采用、常规同主版本非破坏升级 |
wow-debug | 已有失败、hang、错误状态或 reproducer，目标是定位根因；可在授权后修复 | 主动开发、普通 diff review、数据切换 |
wow-review | 目标是 findings、合并准备度或 review-and-fix | 症状驱动诊断、主动功能开发、破坏性迁移专项 |
wow-develop | 设计、实现、测试、重构或解释下游 Wow 行为，包括首次采用 | 已有 diff 审查、已有故障诊断、破坏性迁移 |
如果任务只是通用 Kotlin、Gradle、Dashboard、文档或 DDD/CQRS 讨论，没有范围内的 me.ahoo.wow import、wow-* 依赖或明确下游 Wow 请求，则不激活这些 Skills。Wow 框架仓库自身也不属于四个 Skill 的目标。
源契约：skills/README.md、wow-develop、wow-review、wow-debug、wow-migrate。
所有权与安装边界
| 边界 | 所有者 | 使用方式 |
|---|---|---|
| Skill 行为与 references | Wow 仓库 skills/ | 在本仓库修改并运行本地 validator；不要修改聚合仓库中的生成副本 |
| 可分发插件清单 | Wow 仓库 skills/plugins.json | 当前清单只包含四个 Primary Skills；agents/openai.yaml 提供客户端显示信息与默认提示 |
| 聚合与分发 | Ahoo-Wang/skills | 从聚合市场安装或刷新 ahoo-wow-skills，不把该仓库当作源内容编辑点 |
| 当前安装说明 | Ahoo Skills | 按客户端对应页面执行；安装命令和发布状态可能独立变化 |
| 通用格式 | Agent Skills specification | 只定义通用 Skill 格式，不证明 Wow Skill 的行为正确 |
本仓库不会在应用构建中自动安装 Agent Skills。安装成功只证明客户端发现了插件，不证明某次任务选择正确或结果可靠。
使用请求
请求至少给出四项：
目标：为 Order 增加取消行为
范围：只修改下游 order-domain
授权：允许改代码和测试，不允许发布
证据：运行 :order-domain:test，并报告兼容性与缺失的运行证据Skill 随后应从目标 checkout 建立事实：读取定义、消费者、测试、配置与生成契约；只在授权范围内写入；运行最窄有效检查；准确报告结果与缺失证据。
完整注解参数、DSL 方法、配置键、默认值和后端列表必须从目标版本重新发现。references 只提供稳定决策和发现方法，不能被当作冻结 API 手册。
完成证据
一次 Skill 任务只有在最终报告包含下列内容时才算完成：
- 实际目标版本、范围和授权边界；
- 读取或修改的行为及其事实来源；
- 准确的命令、退出结果和失败数；
- 公开、生成、数据或运行兼容性影响；
- 未执行的外部、生产、数据、发布或回滚验证，明确标为缺失证据。
对于 wow-review，没有授权就保持只读；对于 wow-debug，先复现和定位再修复；对于 wow-migrate，代码、数据、切换和发布权限彼此独立。
维护验证
修改本仓库中的 Skills 后运行：
python3 -S scripts/validate_wow_skills.py
python3 -S -m unittest scripts.test_validate_wow_skills这些命令验证 metadata、agent manifest、插件 include、本地资源路径和 eval JSONL 结构。它们不会执行行为用例，也不会证明自然语言触发、目标 API 或生产迁移正确；行为质量仍需在全新任务中用真实 diff 与命令结果评估。