Craft文档管理

技能简介

通过命令行接口管理 Craft.do 的笔记、文档和任务，支持文件夹浏览、内容搜索、块级编辑及任务状态跟踪。

业务背景

为习惯终端操作的用户提供高效的Craft笔记管理方式。无需打开应用即可快速创建每日笔记、批量整理文档结构，并通过命令行完成跨文档搜索与任务追踪，显著提升知识管理的工作流效率。

落地案例：产品经理晨会前在终端输入craft today查看当日笔记，快速追加会议要点；开发者在代码编写间隙用craft search "API设计"定位历史方案文档，直接复制Markdown块到技术规范中；团队负责人通过craft tasks list筛选未完成任务，一键标记进度，无需切换窗口打断专注状态。

能做什么

• 列出和创建文档，获取每日笔记内容
• 在指定文档中添加、更新或删除 Markdown 块
• 管理收件箱任务，标记完成或删除
• 搜索跨文档内容，查看集合项目

使用说明

1. 安装 CLI：复制 scripts/craft 到 ~/bin/craft 并添加执行权限：
   chmod +x ~/bin/craft
2. 获取 API 地址：在 Craft 应用中进入 设置 > 集成 > Craft Connect > 创建链接
3. 配置环境变量：
   export CRAFT_API_URL='https://connect.craft.do/links/YOUR_LINK/api/v1'
   将上述命令加入 shell 配置文件（如 ~/.zshrc）以持久化
4. 常用命令示例：
   craft folders — 列出所有文件夹
   craft search "关键词" — 搜索文档
   craft add-to-daily "待办事项" — 添加到今日笔记
   craft complete-task TASK_ID — 完成任务

输入与输出

见下方输入与输出表格。

风险提示

• API 链接包含访问凭证，勿提交到公共代码仓库
• 删除块或任务操作不可逆，建议先确认内容
• 环境变量未设置时命令会报错，需检查配置
• Markdown 参数中的引号需正确转义

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/noah-ribaudo/craft/SKILL.md
来源类型：GitHub 仓库