Agent Skills
返回列表
reminds AI 卡片笔记

reminds AI 卡片笔记

知识管理 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8b4cf157/reminds-skills。

技能介绍

要解决的具体问题

在个人知识管理中,私有笔记和稍纵即逝的想法(fleeting thoughts)往往分散在不同工具里,难以快速关联和检索。用户常面临以下痛点:

  • 工具碎片化:笔记、灵感、待办散落在多个平台,无法统一检索。
  • 上下文断裂:想回顾某次随手记录的想法时,难快速定位并关联前后内容。
  • 信息过载与检索低效:面对海量笔记,如何用最少操作找到相关片段。
  • 隐私边界模糊:私有内容存储与调用时,需严格隔离,避免泄露。

reminds AI 卡片笔记官方 Skills 通过统一的 Agent API 接口,帮你用结构化方式管理这些非正式记录,让个人想法可追踪、可检索,同时保持隐私安全。

核心能力

该技能的核心是基于 reminds Agent API 的元数据驱动工作流,支持以下能力:

1. 身份与请求方式

  • API 密钥从环境变量 REMINDS_API_KEY 读取,绝不在日志、URL 或普通聊天中暴露,仅通过请求头透传。
  • API 基址为 https://api.reminds-app.com/v1/agent。
  • 若密钥缺失,需引导用户在提醒应用内创建,并配置到 Shell 或 Agent 环境。

2. 元数据先行与按需取正文

  • 元数据列表/搜索:所有列表或搜索接口只返回元数据(如 GID),不返回正文。需先读取目标内容的 GID。
  • 按需取正文:拿到 GID 后,通过内容接口单独拉取所需片段,避免批量下载冗余,降低带宽和泄露风险。
  • 典型工作流:

- 按最近/更新的笔记:读取 references/memos.md → 列表或搜索元数据 → 按 GID 取正文。
- 按主题/问题:读取 references/memos.md → 搜索元数据 → 按 GID 取正文 → 生成答案 。
- 按最近/匹配的闪念:读取 references/fleetings.md → 列表或搜索 → 按 GID 取正文。
- 保存闪念:读取 references/fleetings.md → 调用唯一的写操作接口。

3. 读写的 workflow 细分

  • 读操作:覆盖笔记与闪念的列表、搜索与正文拉取三者分离。
  • 意图保护:仅当用户明确请求记录或保存时才写入,模糊内容需先确认;超时请求不自动重试;成功时仅返回 GID。
  • 错误处理:遇到非 2xx 响应需读 references/errors.md,不再盲目操作。
  • 界面友好:默认用用户语言回答,时间戳为 UTC ISO 8601 字符串,仅在本地显示有需要时做转换。
  • 无原始暴露:除非用户主动要求,不直接泄露原始 API 响应。

适用边界与注意点

  • 仅读操作:技能不提供修改或删除能力。
  • 不可用内容:回收站与已删除内容视为不可用,不推断缺失 GID 的原因。
  • 上下文安全:避免在聊天中复制敏感正文,展示 GID 即可。
  • 错误处理以 margin 文档为准:非 2xx 响应一律转 references/errors.md,按规范排查。
  • 时间戳转换原则:UTC ISO 8601 字符串仅在需要本地展示时转换,内部统一用 UTC。
  • 展示优先级:生成回答时优先拼接已拉取的正文,减少对原始 API 输出的暴露。

使用场景

  • 回顾上周记录的零散灵感,需先通过元数据搜索定位相关闪念,再按 GID 拉取正文内容。
  • 回答关于个人笔记的主题问题时,需先搜索元数据,再拉取选中的笔记内容进行综合回答。
  • 只有用户明确说“帮我记一下”时,才调用写接口保存新的闪念,不主动写入讨论或草稿内容。
  • 遇到 API 返回非 2xx 错误时,需查阅 references/errors.md,而不是盲目重试已超时的创建请求。

适合人员

  • 独立开发者:构建个人知识库时,需要统一接口聚合和检索私有笔记与灵感。
  • 移动办公的知识工作者:在手机记录碎片想法后,能在桌面通过 API 快速回顾上下文。
  • 自动化工程师:希望基于元数据驱动的工作流,构建定制化的个人笔记检索方案。