核心用途
xz01-dev-skill 是围绕用户现有 OpenClaw/xz01 模板资料建立的角色编排与开发规范体系，服务于 Hermes + Claude Code 的双端（PC+m）模板自动化工厂。它将 /root/.openclaw 明确划定为只读学习资料库，编码修复由 Claude Code（dev）执行，测试输出写入 /www/wwwroot/www.900az.com，验证通过的模板按编号压缩到 /root/.hermes/workspace/xz01/。
显著优点
1. 角色边界清晰：main（调度/报告）、dev（Claude Code 实现）、test（独立 Hermes 验证）、rule（流程审计）四分离，禁止角色坍缩。
2. 硬规则可执行：双端顶部导航必须成对按菜单数据渲染；多页列表必须按 xz01_demo 做双端翻页（PC 数字页码、手机 上一页/下一页）；详情页右侧/底部必须混合游戏+应用+资讯/攻略模块；资源项必须图标化展示。
3. Karpathy 式精准修改：吸收 Andrej Karpathy 的目标驱动原则，要求“先定义成功标准再开发”“只做精确编辑”“以独立验证为准”。
4. Hook 式门禁策略：内置 xz01-hook-gate.py，在 pre-dev/post-dev/pre-test/post-test/pre-package 五个节点拦截非法操作（如写入 OpenClaw、修改 PHP/后端、跳过截图+AI 视觉审查等）。
5. 完整验证链：静态扫描 → HTTP/curl → 整页截图（PC+mobile 真机域）→ AI 视觉 → 规则审计 → 打包，禁止以单点通过替代全流程。
6. Lanhu MCP 集成：支持设计稿需求接入，但管控在 /root/.hermes/workspace/lanhu-mcp，不污染 OpenClaw 目录。
潜在局限与风险
- 学习曲线陡峭：引用文件多达 20+ 篇 session 修正记录，新接入者需通读
references/session-2026-05-18-*.md才能避免重复踩坑。 - 严禁 backend 修改：模板任务禁止触碰
application/**/*.php、config/**/*.php、路由、ThinkPHP 核心；若现有数据/路由无法支撑模板渲染，只能上报限制而非打补丁，可能阻塞需求。 - mobile 验证易错：必须用真机域
m.900az.com+ mobile UA + CDP 指标，390px 桌面域截图会被视为无效移动验证。 - 超时恢复复杂：dev/test worker 超时后不能简单重试，需先检查授权目录时间戳与部分产物，再决定继续或拆分，增加 orchestration 成本。
- 搜索功能弱化：PC 搜索禁止顶部居中，移动搜索仅保留视觉放大镜，若业务需要功能搜索需显式申请。
适合人群
- 需要基于 ThinkPHP + xz01_demo 风格建设高密度下载站门户的前端/模板工程师。
- 追求 dev/test/rule 分离、可审计、可回滚的自动化工厂架构师。
- 已具备 Docker、Playwright/CDP、Hermes/Claude Code 工具链的运维或开发团队。
常规风险
| 风险点 | 说明 |
|--------|------|
| 误写 `/root/.openclaw` | 任何临时脚本、截图、报告、日志禁止落入 OpenClaw 目录，否则视为违规。 |
| 角色坍缩 | main 直接改代码、dev 自测即报 PASS、test 跳过 AI 视觉，均会导致质量逃逸。 |
| 分页实现走样 | 必须照搬 `xz01_demo` 的 `getPcPageData`/`getMobilePageData` → `$page_code` → `{$page_code"。| 双端导航只改一端 | PC 与 mobile 顶部导航是成对需求，单端修复即视为未完成。 |
| 资源项图标遗漏 | 游戏/应用资源出现无图标纯文字横条即 FAIL，新闻文字列表除外。 |
| 打包 gate 绕过 | 未清 runtime、未过 AI 视觉、未验证双端导航/分页/混合模块即打包，会产生无效压缩包。 |