用途
APEX Replatform 用于在目标架构中实现功能规格。它处理的是“映射问题”——将已存在的功能翻译为在新架构中应当存在的形态。典型场景包括重新平台化（replatforming）、代码库迁移，以及在新架构中重建功能。
使用前提
使用此技能前，你应当已经拥有一份描述功能行为的规格文档（来自 apex-decompose 或手动编写）。你不需要访问原始源代码，规格文档就是唯一事实来源。
工作流程
重新平台化一个功能包含以下步骤：
- 加载并理解规格
- 将规格映射到目标架构
- 实现功能
- 接入自校正反馈循环
- 对照规格的验收标准进行验证
第 1 步：加载规格
读取规格文件：
Read specs/{feature-name}.md
识别所有 [VERIFY] 标签。在继续之前，请用户解决任何歧义。不要对已验证的项目进行猜测。
第 2 步：映射到目标架构
创建一个映射文档，将规格概念翻译为目标模式，例如：
| 规格概念 | 目标实现 |
|---|---|
| 数据库写入 users 表 | Prisma user.create() 调用 |
| REST 端点 /api/v1/items | Next.js API 路由 app/api/items/route.ts |
| 事件发出 item.created | EventEmitter / 消息队列发布 |
在编写代码之前，请用户确认映射。这是架构决策点。
第 3 步：实现功能
编写代码时遵循以下规则：
- 一次一个文件。完成每个文件后再继续下一个。
- 严格匹配规格。规格中的每个输入、输出和副作用都必须实现。
- 保留边界情况。如果规格说“为空时返回 400”，就实现该确切行为。
- 添加引用规格的行内注释，例如：
// Spec: Edge Case #3 — concurrent request handling
第 4 步：自校正反馈循环
编写代码后，运行验证链。检测操作系统并使用相应脚本：
Linux/Mac：
bash "${CLAUDE_SKILL_DIR}/scripts/validate.sh" <target-dir>
Windows：
powershell -File "${CLAUDE_SKILL_DIR}/scripts/validate.ps1" <target-dir>
验证脚本按顺序运行：linter、类型检查器、测试、构建。如果任何步骤失败，读取错误输出、修复问题并重新运行。重复直到四项全部通过。在你至少尝试 3 轮修复之前，不要向用户求助。
第 5 步：对照规格验证
遍历规格的每个部分，确认实现覆盖情况：
| 规格部分 | 状态 | 备注 |
|---|---|---|
| 输入 | PASS/FAIL | 所有参数已处理 |
| 输出 | PASS/FAIL | 响应结构匹配 |
| 副作用 | PASS/FAIL | 所有变更已实现 |
| 边界情况 | PASS/FAIL | 每种情况都有代码路径 |
| 依赖 | PASS/FAIL | 所有包已安装 |
创建草稿 PR，并在描述中包含此检查清单。
输出
在目标架构中生成与规格匹配的可工作实现，验证链通过，并生成一份可供人工审查的草稿 PR。
示例 PR 正文：
## apex: Implement user-authentication from spec
### Spec Coverage
| Section | Status | Notes |
|---------|--------|-------|
| Inputs | ✅ PASS | All parameters handled |
| Outputs | ✅ PASS | JWT + cookie response |
| Side Effects | ✅ PASS | Session + event implemented |
| Edge Cases | ✅ PASS | 401/403 paths verified |
### Validation Results
- Lint: ✅ PASS
- Types: ✅ PASS
- Tests: ✅ PASS (12 new, 0 failing)
- Build: ✅ PASS
### Files Changed
- `src/auth/login.ts` (new)
- `src/auth/session.ts` (new)
- `src/events/user.ts` (modified)
适用场景
- 重新平台化：将功能从旧架构迁移到新架构
- 代码库迁移：在新技术栈中重建已有功能
- 基于规格的功能重建：当已有明确规格文档时，在目标架构中实现
限制
- 需要一份描述功能行为的规格文档作为输入，规格是唯一事实来源
- 不需要访问原始源代码
- 遇到 [VERIFY] 标签时需用户解决歧义，不能猜测
- 映射阶段需用户确认架构决策
- 验证链失败时需至少尝试 3 轮修复后才可求助用户
- 关于收费、价格、平台支持范围等信息暂未提供