核心用途
xz01-dev-skill 是 Hermes 与 Claude Code 围绕用户现有 OpenClaw/xz01 模板资料进行协作开发的角色编排与流程规范。它将开发工作拆分为 main（调度）、dev（实现）、test（验证）、rule（审计） 四个独立角色，严格禁止角色坍缩。
关键边界与规范
只读学习资料库
/root/.openclaw及其所有子目录为只读学习资料，禁止写入、修改、补丁操作- 允许：读取目标文件、目录清单、规则摘要、惯例学习、报告对比
- 禁止：写入配置、技能、记忆、定时任务状态、会话流、模板或生成报告
开发范围限制（模板开发）
- 禁止修改：
application/**/*.php、config/**/*.php、route/**/*.php、ThinkPHP 核心、vendor、任何控制器/模型/服务/后端 PHP 文件 - 允许范围：
public/themes/<theme>/**（HTML 模板、CSS、JS、主题资源） - 若现有后端/模板标签无法提供所需数据/路由，应报告限制而非补丁 PHP
输出路径规范
- 所有测试侧输出、验证产物、截图、报告、网站验证输出 →
/www/wwwroot/www.900az.com - 验证通过的模板压缩包 →
/root/.hermes/workspace/xz01/（按编号命名） - Hermes 技能存储 →
~/.hermes/skills/...
严格打包门槛
每次增删改开发后必须：
1. 删除 /www/wwwroot/www.900az.com/runtime/ 下所有目录/文件
2. 验证通过才允许打包：PC/移动端首页、软件/游戏列表页、详情页必须真实渲染、无 500 错误、无 ThinkPHP 错误链接、无缺失 jQuery、无双前缀 URL、无禁止的 SVG 填充图、无大量「暂无数据」占位符
3. 分类页显示名必须使用 cmf_cms_channel.name（如别名 gzos 显示「手游下载」）
4. PC 搜索框禁止置顶居中；移动端搜索可视但默认可用（除非用户明确要求功能搜索）
5. PC 与 m 端顶部导航必须成对处理，均从现有菜单数据渲染（get_nav_menu / $vo.name / $vo.href），禁止硬编码猜测标签
验证要求
- PC 截图：桌面 UA +
https://www.900az.com/ - 移动端截图：真实 Android/iPhone Mobile UA +
https://m.900az.com/，DevTools 模拟 390px/430px - AI 视觉分析为必需环节，不得跳过
- 全站截图/AI 复检时：每个爬取 URL 必须有截图清单、超时重试、生成联系表、AI 审核
Karpathy 精准修改原则
1. 编辑前思考，但不过度询问；边界问题才需确认
2. 保持实现简洁，不添加未请求的抽象
3. 精准编辑，每行修改必须映射到当前验收目标
4. 开发前定义成功标准：目标页面/组件/缺陷、允许文件、禁止文件、runtime 清理要求、测试验收标准
5. 以目标验证，非以开发自信验证；官方通过需独立测试截图 + AI 视觉审核
时间控制与任务拆分
- 禁止通过提高
--max-turns解决长任务 - 所有工作拆分为最小实践单元
- 使用固定验证脚本而非临时命令
- 默认严格串行队列：单活跃开发任务、单活跃测试任务、单活跃规则审核；无并发除非用户显式启用
- 长时间运行任务及时拆分，使用 Claude 交互/tmux 作为监督工作台
角色分工
| 角色 | 默认执行者 | 职责 | 能否写 /root/.openclaw |
|:---|:---|:---|:---|
| main | Hermes 当前会话 | 接收请求、拆分工作、调度、监督、最终报告 | 否 |
| dev | Claude Code | 在授权工作目录实现代码/模板变更 | 否 |
| test | 独立 Hermes 测试会话 | 截图、AI 视觉分析、lint/HTML/CSS/模板验证 | 否 |
| rule | 独立 Hermes 规则会话 | 流程审计、规则审核、技能/规范建议 | 否 |
禁止事项
- main 直接修补实现文件（即使缺陷明显或紧急）
- dev 自认证最终验收、跳过测试、执行官方截图/AI 视觉验证
- test 直接修复问题、编写实现代码
- 任何角色写入 OpenClaw 文件（除非用户显式授权）
- 复制
demo_xz01作为可编辑源码（仅作模式库参考）
技能持续改进
- 当用户纠正角色分工、新增硬边界、补充学习范围、出现重复错误、证明某命令/路径/工具模式有用时，应在本技能内补丁
- 编辑后必须：更新
SKILL.md版本 → 同步skill.json→ 同步_meta.json→ 运行clawhub publish（不问确认） - 不为一过性任务进度、临时路径、短期会话 ID 补丁技能
显著优点
- 角色隔离清晰：杜绝「既当裁判又当运动员」的质量风险
- 只读边界严格：保护用户现有 OpenClaw 资产不被意外污染
- 验证门槛硬化：runtime 清理、双端截图、AI 视觉、静态扫描、URL 爬检等多层关卡防止无效打包
- 精准修改原则：吸收 Karpathy 目标驱动理念，减少过度工程和无关改动
- 任务拆分机制：通过强制小单元+串行队列，避免
max_turns中断和 50 分钟超长任务
潜在局限
- 流程 overhead 较高：小修小补也需完整 dev→test→rule 闭环，可能显得繁琐
- 对自动化脚本依赖：若验证脚本未就绪，临时检查易遗漏
- 移动端验证成本：真实 Mobile UA + 390px/430px 双重验证增加截图复杂度
- 串行队列吞吐：默认禁止并发，批量模板生产效率受限（除非用户显式启用并发）
- AI 视觉非确定性：依赖 AI 判断视觉缺陷，可能存在主观差异
适合人群
- 需要严格质量管控的 xz01 模板工厂化生产团队
- 现有 OpenClaw 资产需只读保护、另建新流程的用户
- 追求角色分离、可审计、可追溯开发流程的技术负责人
- 希望渐进式自动化（从脚本到 Kanban 工厂队列）的团队
常规风险
- 角色坍缩风险：紧急修复时易 temptation 让 main 直接改代码，违反用户显式纠正过的规则
- runtime 缓存陷阱：忘记清理
/runtime/导致旧模板隐藏问题，打包后失效 - 双端导航遗漏：只修 PC 或只修移动端导航，留下另一端硬编码
- 搜索功能误判：将「禁用行为但保留视觉」理解为「删除搜索框」，导致模板不完整
- 技能版本漂移：编辑后未执行
clawhub publish，导致后续会话加载旧版本 - OpenClaw 运行时混淆：直接调用
sessions_send、flow-controller等 OpenClaw 概念而非 Hermes 原生方案