craft-cli

该技能封装了 craft-cli 工具，为用户提供与 Craft.do 知识库交互的标准化接口。核心用法涵盖文档的全生命周期管理：通过 list、search 实现文档检索，支持 JSON、Markdown、Table 三种输出格式；利用 create、update、delete 完成文档的增删改，支持从文件读取或内联 Markdown 输入；同时提供 config 命令管理 wavedepth（商业）与个人双空间配置。特别设计了 craft-helper.sh 脚本实现工作区快速切换，适配多场景需求。

显著优点体现在架构设计与使用体验两个维度。其一，JSON 默认输出格式专为 LLM 优化，可直接管道传输至 jq 等工具进行数据处理，极大降低了 AI 工作流的上下文消耗；其二，安装部署简单，仅需下载单二进制文件并配置 API 端点即可使用，无复杂依赖；其三，支持父子文档嵌套创建与多格式导出，满足知识库结构化需求；其四，完善的错误码体系（0-3 级）与清晰的错误提示，便于自动化脚本中的异常处理。

潜在缺点主要源于其架构定位。首先，强依赖第三方 SaaS 服务 Craft.do，需保持网络连通性，且受限于 Craft.do API 的可用性与速率限制；其次，作为 T3 来源的个人项目，长期维护稳定性与功能迭代速度存在不确定性；再者，当前仅支持 Craft.do 生态，无法迁移至其他文档平台；最后，虽然二进制文件版本锁定，但需通过 curl 从 GitHub 下载，在严格安全环境中可能受限于网络策略。

该技能特别适合以下群体：需要将 Craft.do 纳入自动化工作流的知识管理用户；构建基于文档数据的 LLM Agent 的开发者；以及习惯命令行操作、追求效率的商务人士。对于频繁需要在 Craft 文档与代码仓库、CI/CD 流程间同步内容的研发团队尤为适用。

使用风险方面，需关注 API 密钥安全：配置中的 Craft.do API 链接等同于访问令牌，应妥善保管避免泄露；网络传输风险：所有文档内容通过 HTTPS 与 Craft.do 服务器交互，虽加密传输但存在云端托管风险；参数注入：craft-helper.sh 使用 $@ 传递参数，若处理不可信输入可能导致意外行为；最后，预编译二进制文件的完整性验证需用户自行确保，建议校验发布页 SHA256 值。