核心用法
xz01-dev-skill 是面向 Hermes + Claude Code 协作流程的编排规范，核心解决三个问题：
1. 角色边界清晰化：Main（调度）、Dev（Claude Code 实现）、Test（独立验证）、Rule（规则审计）四角色分离，禁止角色坍缩
2. 只读边界强制执行：/root/.openclaw 及其全部子目录为只读学习资料库，禁止写入配置、技能、模板、报告等任何文件
3. 双端模板工程规范：PC 与移动端（m.900az.com）必须成对开发验证，顶部导航必须按现有菜单数据动态渲染，禁止硬编码猜测标签
显著优点
- 工业级分工：吸收 Karpathy"精准修改/目标驱动"原则，每个变更必须映射到具体验收目标，禁止"顺手优化"邻近代码
- 硬边界防护：通过 hook-style gate 脚本在 pre-dev/post-dev/pre-test/pre-package 等关键节点强制检查，防止
/root/.openclaw写入、PHP 后端越界修改、未清缓存验证等常见违规 - 视觉验收标准化：整页截图（非首屏）+ 分段 contact sheet + AI 视觉分析的三层验证，杜绝"首屏通过即打包"的漏检风险
- 移动端专项保障：CDP 真机 UA 模拟（390px/430px）+ 运行时 overflow probe，解决模拟器与真机差异导致的布局溢出
- Lanhu MCP 集成：设计稿对接通过独立 Docker 服务（
/root/.hermes/workspace/lanhu-mcp）完成，不污染只读学习区
潜在局限
- 串行队列限制：默认禁止并发 dev/test/rule 执行，稳定性优先但吞吐受限；需用户显式授权方可开启并行
- 无自动安全扫描：用户明确排除通用安全扫描需求，仅保留 xz01 专用 gate
- 后端扩展受限：模板开发禁止修改 PHP/controller/model/config/route，数据缺失时需报告限制而非补丁后端
- 验证脚本依赖：静态扫描、URL 爬取、截图等工具需预置在
/root/.hermes/workspace/xz01-factory/tools/，环境未就绪时流程阻塞
适合人群
- 运行 xz01 模板工厂的多人/多 Agent 协作团队
- 需要严格区分"学习参考"与"生产输出"边界的技术管理者
- 追求"视觉还原度"优先于"功能可用"的下载站/门户类前端项目
- 使用 ThinkPHP + 双端主题（PC/mobile）架构的 PHP 开发者
常规风险
| 风险点 | 说明 | 缓解措施 |
|--------|------|----------|
| 缓存污染 | ThinkPHP runtime 残留导致"修改未生效"幻觉 | 每次增删改后强制清空 `/www/wwwroot/www.900az.com/runtime/` |
| 双端导航不同步 | 只修 PC 忽略 mobile 或反之 | 导航任务必须成对验证，mobile 使用 `m.` 主机替换 |
| 搜索框功能残留 | 用户要求"弱化搜索"时误删视觉或保留功能 | 视觉保留但禁用 input/submit/JS 绑定，无 `/search` action |
| URL 双前缀 | `cmf_url()` 已返回绝对 URL 时再次拼接协议主机 | 标准化检查，禁止 `https://...https://...` 模式 |
| 打包过早 | 未验证详情页、分页、真实数据即打包 | 硬 gate：首页/列表/详情渲染通过 + jQuery/分页/链接检查 + 截图 AI 通过后才允许 zip |
关键路径示意
用户请求 → Main 拆分为最小单元 → Claude Dev 实现（仅 themes/<theme>）→ 清空 runtime → Test 整页截图 + AI 视觉 → Rule 审计 → 验证通过 → 打包至 /root/.hermes/workspace/xz01/编号.zip → Main 报告