工作区模板比对

技能简介

该技能用于将用户本地的Clawdbot工作区配置文件（AGENTS、SOUL、USER、IDENTITY、TOOLS、HEARTBEAT等）与官方模板进行逐文件比对，识别缺失的章节内容，辅助用户在版本升级后完成配置同步。

业务背景

该技能帮助用户在 Clawdbot 版本升级后快速完成配置同步。通过逐文件比对本地工作区与官方模板，精准识别缺失章节，避免因配置遗漏导致的功能异常或启动失败，降低版本迁移的人工排查成本。

落地案例：用户将 Clawdbot 从 v0.5 升级至 v0.6 后，发现部分新功能无法启用。运行工作区模板比对技能，工具自动扫描 AGENTS、SOUL、TOOLS 等核心文件，标记出 v0.6 模板新增的三个配置段落，并附官方原文引用。用户按建议补充后，系统恢复正常，全程无需翻阅冗长的更新日志。

能做什么

• 自动定位Clawdbot安装目录下的官方模板路径
• 逐文件对比工作区与模板的章节结构差异
• 过滤掉仅包含前置元数据和引导内容的差异
• 生成缺失章节的清单并给出添加建议

使用说明

1. 安装要求：无需额外安装，Clawdbot内置技能；需确保本地已安装Clawdbot（npm/pnpm全局安装或源码运行）
2. 定位模板目录：
   npm/pnpm安装：npm root -g 或 pnpm root -g 查找 clawdbot/
   源码运行：直接使用检出根目录（含package.json）
3. 执行比对：
   确认工作区根目录 → 遍历 <clawdbot-root>/docs/reference/templates/（跳过*.dev.md）→ 逐文件调用diff工具对比
4. 查看结果：按文件路径列出缺失章节，附原文引用和操作确认问题

输入与输出

见下方输入与输出表格。

风险提示

• 无法自动定位安装路径时需手动指定Clawdbot根目录
• 仅检测章节缺失，不验证配置内容的正确性
• 升级后旧版自定义内容可能被覆盖，建议先备份
• *.dev.md开发模板不在比对范围内

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/xadenryan/clawdbot-skill-clawdbot-workspace-template-review/SKILL.md
来源类型：GitHub仓库