核心用法
xz01-dev-skill 是一套为 Hermes 与 Claude Code 设计的精密协作工作流，专用于围绕用户现有 OpenClaw/xz01 模板资料进行角色编排开发。核心架构采用 Main → Dev → Test → Rule 四级分离模式：
- Main（Hermes）：任务分发与最终汇报，禁止直接编码
- Dev（Claude Code）：唯一编码实现者，限定在
public/themes/<theme>目录 - Test（独立 Hermes 会话）：截图、AI 视觉分析、静态扫描验证
- Rule（独立 Hermes 会话）：流程审计与技能规范维护
关键边界约束
| 约束项 | 规则 |
|--------|------|
| `/root/.openclaw` | **只读学习资料库**，禁止任何写入 |
| 后端文件修改 | 模板开发严禁触碰 `application/**/*.php`、`config/**/*.php`、路由等 |
| 测试输出路径 | `/www/wwwroot/www.900az.com` |
| 验证通过模板包 | `/root/.hermes/workspace/xz01/`（编号压缩归档） |
| Runtime 清理 | 每次增删改后必须清空 `/www/wwwroot/www.900az.com/runtime/` |
显著优点
1. Karpathy 精准修改原则：目标驱动、最小改动、不添加未请求抽象
2. Hook-Style Gate 机制：预置 pre-dev/post-dev/pre-test/pre-package 等校验脚本
3. 双端强制同步：PC 与移动端顶部导航必须成对按菜单数据渲染，禁止硬编码
4. 视觉验收标准化：整页截图 + 分段 AI 检查，禁止首屏截图即 PASS
5. 资源卡片化强制规则：所有 App/游戏/应用资源项必须图标化展示，禁止纯文本横排
潜在局限与风险
- 学习曲线陡峭：大量交叉引用文件与边界规则，新用户易误触只读禁区
- 流程刚性：角色不可折叠，小缺陷也需完整 dev→test→rule 循环
- 超时恢复复杂：需人工检查部分产物状态，再拆分为更小任务
- 无原生并发支持：默认串行队列，大规模并行需显式授权
适合人群
- 有明确 xz01/OpenClaw 模板资产的技术团队
- 需要严格质量门禁与可追溯审计的企业级开发场景
- 追求 AI 辅助开发但坚持人工终审的保守架构
常规风险
- 误将
/root/.openclaw当作可写配置目录 - Claude 自我认证通过，跳过独立 Test 验证
- 分页规则漏检：多页列表必须有 PC 数字分页 + 移动端「上一页/下一页」
- 搜索功能误保留：视觉搜索框必须禁用行为（无 action、无 submit、无 JS 绑定）
- 移动端验证使用桌面 UA 导致假 PASS
版本演进要点
当前 v1.0.39 整合了 2026-05-18 密集会话修正：导航栏数据驱动渲染、双端分页强制规则、详情页混合模块、资源图标化、整页视觉验收、Hermes 原生编排边界等关键硬规范。