Craft CLI Skill 综合评估
核心用法
Craft CLI 是一款命令行工具，用于与 Craft Documents 知识管理平台进行交互。用户通过配置 API URL 连接特定工作空间（如 wavedepth Business 空间或个人空间），即可在终端执行文档的全生命周期管理操作。
主要功能模块：
- 文档检索：
list列出所有文档，search全文检索，get获取指定文档内容 - 文档管理：
create创建（支持标题、文件、内联 Markdown、父子层级），update更新，delete删除 - 配置管理：
config set-api/get-api切换工作空间，支持 helper 脚本快速切换 - 多格式输出：JSON（默认，LLM 友好）、table（人工可读）、markdown
典型工作流：
1. 配置 API 端点 → 2. 列表/搜索定位文档 → 3. 获取内容处理 → 4. 更新或导出结果
显著优点
1. LLM 原生设计：JSON 默认输出、清晰的结构、支持管道操作（| jq），天然适合自动化处理
2. 多空间支持：通过 API URL 灵活切换 Business/Personal 空间，配合 helper 脚本实现无缝切换
3. 格式灵活：同一命令支持三种输出格式，兼顾机器处理与人工阅读
4. 完整的 CRUD：覆盖文档管理的全部核心操作，支持父子层级组织
5. 错误码规范：0-3 分级退出码，便于脚本错误处理
潜在缺点与局限性
1. 外部依赖重：完全依赖 Craft.do 官方 API 可用性，无离线能力
2. 认证风险：API URL 包含完整认证令牌，一旦泄露即获得空间完全访问权限
3. 速率限制：存在 rate limit exceeded 错误，高频自动化场景可能受限
4. 安装非标准：需手动下载二进制并 sudo mv，无包管理器支持
5. 社区规模：GitHub 仓库 nerveband/craft-cli，属于个人/小众项目，长期维护存疑
适合人群
- Craft.do 重度用户：已有 Craft 工作空间，需批量操作或自动化集成
- LLM 工作流构建者：需要将 Craft 文档纳入 AI 处理管道的开发者
- CLI 偏好者：习惯终端操作、追求效率的技术人员
- 不适合：无 Craft 账户者、完全离线需求者、对 API 安全敏感的企业环境
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| **令牌泄露** | API URL 即凭证，泄露后他人可完全控制空间 | 使用环境变量/密钥管理，避免硬编码；定期轮换链接 |
| **误操作覆盖** | `update` 无确认提示，可能意外覆盖内容 | 操作前 `get` 备份，使用版本控制 |
| **依赖失效** | 个人项目可能停更，API 变更导致功能损坏 | 锁定版本，关注仓库动态 |
| **数据出境** | 文档内容通过 Craft 云端 API 传输 | 敏感数据评估合规性 |
版本信息
当前版本：v1.6.0