reminds AI 卡片笔记
将以下提示词粘贴到你的 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 快速回顾上下文。
- 自动化工程师:希望基于元数据驱动的工作流,构建定制化的个人笔记检索方案。