Clawdbot 文档智能导航专家

Clawdbot 官方文档专家技能，提供决策树导航、搜索脚本与配置片段，帮助用户快速解决部署配置与故障排查问题。

基本信息

• 技能名称?clawddocs
• 中文名称?Clawdbot 文档智能导航专家
• 作者?NicholasSpisak
• 分类?开发
• 版本?v1.2.2
• 标签?docs, automation, devops, backend, customer-support, development-engineering

使用方法

使用说明
核心用法
Clawddocs 是专为 Clawdbot 生态打造的文档专家技能，采用决策树导航模式帮助用户快速定位所需信息。用户可通过结构化问答路径（如"如何设置X""为什么X不工作""如何配置X"等）自动路由到对应文档章节，无需手动翻阅完整文档库。技能内置 7 个 Shell 脚本工具，覆盖站点地图浏览、关键词搜索、全文索引构建、文档获取、版本变更追踪等核心场景，并附带常用配置片段库，可直接复制用于生产环境。
显著优点

1. 结构化导航效率极高 ：决策树设计将复杂的文档体系转化为可交互的问答流程，显著降低新用户的学习成本。
2. 多维度检索能力 ：支持关键词搜索、全文语义检索（需 qmd 工具）、时间维度筛选（recent.sh）三种发现机制，适应不同查询习惯。
3. 配置即拿即用 ： snippets/common-configs.md 提供经过验证的 JSON 配置模板，涵盖主流平台（Discord、Telegram、WhatsApp 等）的接入方案，减少试错成本。
4. 版本感知 ： track-changes.sh 支持文档快照与差异对比，便于追踪 Clawdbot 功能迭代对配置的影响。
5. 生态完整性 ：覆盖从安装部署（Docker/Linux/macOS）、平台接入、网关配置到自动化任务（Cron/Webhook）的全生命周期场景。
   潜在缺点与局限性
6. 脚本为占位实现 ：当前版本所有 Shell 脚本仅输出提示信息，无实际功能，用户需手动执行对应操作或等待后续更新。
7. 全文索引依赖外部工具 ：语义搜索功能需要额外安装 qmd 工具，增加了使用门槛。
8. 缓存机制简单 ：1 小时 TTL 的缓存策略在文档频繁更新时可能导致信息滞后。
9. 无实时验证能力 ：技能无法直接检测用户配置的有效性，仅能提供文档参考，配置错误仍需用户自行排查。
10. 平台覆盖偏向海外 ：Provider 列表以 Discord、Telegram、WhatsApp 等国际平台为主，国内平台（微信、钉钉、飞书）支持情况需额外确认。
    适合的目标群体
    Clawdbot 新用户 ：需要快速完成首次部署和平台接入配置
    运维与 SRE 工程师 ：负责网关配置、健康监控、日志排查等运维任务
    自动化开发者 ：需要配置 Cron 任务、Webhook、Gmail Pub/Sub 等自动化流程
    多平台 Bot 开发者 ：同时在多个聊天平台（Discord、Telegram、Slack 等）部署机器人的技术团队
    技术文档贡献者 ：需要追踪文档变更历史、理解信息架构的社区成员
    使用风险
11. 功能依赖风险 ：当前脚本为占位实现，若用户误以为是自动化工具直接调用，可能导致操作未执行而误以为完成。
12. 配置片段适用性 ：提供的 JSON 配置为通用模板，实际部署时需根据具体版本和环境调整，直接复制可能引发兼容性问题。
13. 文档时效性 ：缓存机制可能导致用户获取到已过时信息，关键配置变更建议通过 recent.sh 或官方渠道二次确认。
14. 外部工具链依赖 ：全文索引、文档获取等高级功能依赖 qmd 等外部工具，环境缺失时功能降级为纯文本提示。
15. 无权限隔离设计 ：技能本身不处理敏感数据，但用户在使用过程中可能自行输入 API Key、Token 等凭证，需注意终端历史记录的安全清理。