核心定位
xz01-dev-skill 是围绕 Hermes 与 Claude Code 协作的专项开发规范，用于管理用户现有 OpenClaw/xz01 模板资产的双端（PC + 移动）开发与交付流程。
核心用法
- 触发机制：用户提及"xz01规范""xz01-dev-skill"等关键词时自动命中
- 角色编排：
- Main（Hermes 主会话）：任务调度、最终报告，不直接编码
- Dev（Claude Code）：模板实现，仅限
public/themes/<theme>目录，禁止触碰 PHP/后端/路由 - Test（独立 Hermes 会话）：截图、AI 视觉验证、回归测试
- Rule（独立 Hermes 会话）：流程审计、规则固化、技能迭代
- 严格边界：
/root/.openclaw为只读学习资料库，禁止任何写入；测试输出写入/www/wwwroot/www.900az.com；验证通过的模板按编号压缩至/root/.hermes/workspace/xz01/
显著优点
1. 边界清晰：四层角色分离杜绝"既当裁判又当运动员"，Main 绝不直接 patch 代码
2. 流程闭环：Dev → Test → Rule → Main 的串行队列确保每一步可验证、可追溯
3. 双端强制覆盖：PC 与移动导航必须成对按菜单数据渲染，拒绝硬编码
4. 验收标准硬约束：整页截图 + AI 分段检查、分页必须遵循 xz01_demo 链式模式、资源项必须图标化
5. 防错机制：内置 hook-style gate 脚本，在开发前/后、测试前/后、打包前设置拦截检查
潜在缺点与局限
- 学习曲线陡峭：开发者需同时理解 ThinkPHP 模板标签、
xz01_demo模式、双端响应式差异及 AI 视觉验收标准 - 串行效率：默认禁用并发，大规模模板批量生产时吞吐量受限
- 外部依赖：需配合
demo_xz01作为模式库、Lanhu MCP 作为设计源（可选），若参考材料缺失或过期会导致实现偏差 - 移动验证复杂：必须使用真实移动域名
m.900az.com+ CDP 设备模拟，仅改 viewport 宽度不足以通过验收
适合人群
- 需要严格质量管控的 xz01 模板开发团队
- 熟悉 ThinkPHP + 双端前端、能接受细粒度验证流程的开发者
- 已将 OpenClaw 资产作为历史参考、希望在 Hermes 生态内重建生产流程的组织
常规风险
| 风险类型 | 说明 |
|---------|------|
| 越界写入 | 误将 `/root/.openclaw` 当作可写目录，导致资料库污染 |
| 后端侵入 | 为快速修复模板而修改 PHP/控制器/路由，破坏主题隔离原则 |
| 验证冒进 | 未清 runtime 缓存即截图、未做整页 AI 检查即标记 PASS |
| 分页造假 | 自定义分页算法而非遵循 `getPcPageData/getMobilePageData → $page_code` 链 |
| 移动端伪证 | 用 `www.900az.com` 390px 截图冒充移动站验收 |
| 打包前置 | 未通过全部门控即生成 zip，导致不合格模板流入 `/root/.hermes/workspace/xz01/` |