monologue-notes

Monologue 笔记

当 Agent 需要通过公共 API 只读访问 Monologue 笔记时，请使用此技能。

当前公共接口包括：

• GET /v1/public-api/notes
• GET /v1/public-api/notes/{note_id}
• GET /v1/public-api/notes/{note_id}/audio-url

此技能以 Shell 为主，因此适用于可运行终端命令的各类 Agent，包括 Codex 和 Claude Code。

设置

如果缺少 monologue CLI，请安装：

curl -fsSL https://raw.githubusercontent.com/EveryInc/monologue-toolkit/main/install.sh | sh

如果尚未配置凭据，请运行引导流程：

monologue onboarding

引导流程只能由用户手动完成。请用户打开自己的交互式终端，在 Monologue 应用中创建 Monologue Notes API 令牌，并自行运行 monologue onboarding。暂停操作，直到用户确认已完成。

切勿要求用户在聊天中粘贴令牌。切勿将令牌放入工具调用、命令参数、文字记录、日志或回复中。不要尝试自动执行引导流程，也不要绕过交互式终端检查。

命令

直接使用 CLI：

monologue notes list --limit 10
monologue notes list --q "customer interview"
monologue notes list --tag-id TAG_UUID
monologue notes all --updated-after 2026-01-01T00:00:00Z
monologue notes get note_123
monologue notes get note_123 --field transcript
monologue notes get --field summary note_123
monologue notes get note_123 --field recording_url
monologue notes audio-url note_123 --field audio_url

访问录音需要 CLI v0.3.0 或更高版本。notes get 会返回原始录音链接、UTC 过期时间、内容类型和字节数。notes audio-url 会返回一个新的链接及其有效时长（秒）。列表输出保持不变。只有当录音与用户的请求相关时，才获取或下载录音。签名链接在过期前无需 API 令牌即可授权访问；请勿将其放入共享回复或日志中。有关下载和过期行为，请参阅 references/api.md。

检索流程

1. 如果缺少 CLI，请安装。
2. 如果缺少凭据，请停止并让用户在自己的终端中运行 monologue onboarding。 只有在用户确认完成后才能继续。
3. 搜索前先确定范围：主题、人员、项目、所需日期范围和用户的时区。在该时区内解析“上周”等相对日期，将起止时间转换为 ISO 8601 格式；如果解析后的范围会影响答案，请说明该范围。
4. 根据 recorded_at 匹配用户指定的录制时间范围，而不是 created_at。 created-after 和 created-before 用于筛选后端创建笔记的时间，因此可能会漏掉延迟上传的笔记。对于需要穷尽检索的录制时间请求，请获取所有匹配的候选笔记，并在本地筛选其 recorded_at 值。如果没有 recorded_at，只能将 created_at 作为明确说明的备用依据。只有当用户询问笔记的创建时间，或接受已说明的覆盖范围优化时，才使用创建时间筛选条件。
5. 使用多个有针对性的查询进行搜索。尝试主题、人员、项目和特征短语的不同变体，不要只依赖一个宽泛查询。如果相关结果可能跨越多页，请使用 all。
6. 仅将列表或搜索匹配项视为候选项。结果可能只是提到了某个人或主题。使用 get NOTE_ID 获取每个合理的候选项，检查其文字记录和元数据，并确认日期、参与者和主题确实符合请求。
7. 只有在确定候选项后，才使用 --field transcript 或 --field summary。如果需要通过标题、时间戳、标签或文字记录片段进行核验或溯源，请获取完整数据。
8. 如果首次搜索没有结果，可通过每次放宽一个条件来扩展搜索一到两次。报告检查过的范围和查询；不要将不完整的搜索说成不存在相关笔记。
9. 只综合已核实的来源。将工作和个人内容分开，并遵守下文的隐私和归属规则。

回复风格

• 用户要求近期笔记或摘要时，优先提供简短摘要，而非原始 JSON。
• 除非用户明确要求提供 ID，或后续操作需要 ID，否则将 note_id 保持为内部信息。
• 为每个来源标注易读的出处信息：笔记标题和用户时区下的日期。如果需要区分名称相似的笔记，则添加记录时间。
• 明确区分直接的转录证据与综合整理或推断。只有转录中确实出现的词语才使用引号；否则请改述。
• 对于涉及多条笔记的回答，最后简要列出实际使用的笔记作为来源。不要引用检查后未采用的候选笔记。

参考资料

• 阅读 references/api.md，了解准确的已发布架构。
• 如果缺少 CLI 或环境需要设置方面的帮助，请阅读 references/install.md。

防护措施

• 此技能为只读。不要编造创建、更新或删除端点。
• created-after、created-before 和 updated-after 使用 ISO 8601 时间戳。
• 优先使用 CLI，而不是临时使用 curl，以确保身份验证、错误处理和分页保持一致。
• 不要将安装技能本身视为安装后的执行钩子。请安装 CLI，并在首次使用时运行引导流程。
• 切勿在聊天或工具参数中请求、显示、回显、记录或传递 API 令牌。只有用户可以在交互式引导流程中输入令牌。
• 不要在工作内容综合中悄然混入个人笔记。除非用户明确要求纳入，否则排除明显属于个人的内容。如果归类存在歧义，且是否纳入会实质性影响答案，请先询问。
• 只有在转录内容同时支持说话者身份和承诺时，才将决定、承诺和行动项归于该说话者。不要把建议、问题、集体的“我们”或他人的计划转化为用户的承诺。
• 除非笔记或上下文转录能够确认，否则将说话者标签视为未经核实。如果身份不确定，请称其为“身份不明的说话者”。