SuperAPI AI 工具集

inbox-setup

办公与效率

查看项目

更新于 10-15 16:29

技能介绍

用途

Inbox-Setup 是一个一次性配置技能,用于为收件箱分诊(inbox triage)建立个性化的知识库。它与 inbox-triage 技能配对:本技能负责写入知识库,inbox-triage 在每次运行时读取该知识库。两个技能之间的文件契约(文件名、章节、字段)必须完全一致。

该技能通过交互式访谈了解用户的邮件模式、业务背景、回复风格和优先级,然后在 ${WORKSPACE}/Email/ 目录下生成结构化知识库,捕获 inbox-triage 高效处理收件箱所需的一切信息。

主要能力

  • 通过 8 个章节的引导式访谈收集用户信息
  • 生成 7 个知识库文件(部分为条件性生成)
  • 支持重新运行,检测已有文件并逐文件询问替换/合并/跳过
  • 提供脚本工具进行知识库验证、进度跟踪和语音样本分析

使用方式

调用触发词

  • "set up my inbox"
  • "configure inbox triage"
  • "set up my email system"
  • "configure email triage"
  • "build my email knowledge base"
  • "initialize email management"
  • "set up inbox triage"
  • "onboard email triage"

访谈纪律

  • 不要一次性生成所有文件。逐一走完 8 个章节,每个章节在继续前先提交其文件。部分完成(例如用户中途退出)仍会生成可用的部分知识库。
  • 全程遵循 "grill-me" 纪律:每轮只问一个问题,绝不打包提问,即使跨章节边界也是如此;每个问题都附带 "我为什么问这个";尽可能使用强制格式(多选优于开放式);按依赖顺序提问。

知识库文件契约

在 ${WORKSPACE}/Email/ 下生成以下文件:

文件 用途 是否必需
email-taxonomy.md 分类系统 + 报告偏好 是
email-patterns.md 回复语气、语调、模板、硬性规则 是
evaluation-framework.md 机会类邮件的决策树 仅当用户收到推销/机会邮件时
rate-card.md 定价、条款、谈判姿态 仅当用户有定价时
blocklist.md 自动跳过的发件人 + 学习到的拒绝模式 是(初始填充,随时间增长)
tracker.md 活跃跟进、逾期事项、截止日期 是(初始大多为空)
triage-log/ 每次运行的日志目录 是(创建为空目录)

停止条件

8 个章节共约 25–31 个问题(取决于跳过逻辑)。硬上限:包括所有子澄清在内共 35 个问题。当第 1 章未出现机会邮件类别时,第 4 章(评估框架)完全跳过,总数减少 6 个问题并跳过 rate-card 文件。第 8 章确认 + 交接消息后,访谈关闭,不再重新打开。之后如需更改偏好,用户重新运行该技能(检测已有文件并逐文件询问:替换/合并/跳过)。

各章节内容

第 1 章:全局概览(6 个问题) 了解用户的角色和业务、收件箱主要邮件类型、大致量级分布、需要覆盖的邮箱地址、运行频率、是否有助手协助管理邮件。此阶段不写文件,仅建立心智模型,并记录是否存在机会邮件类别(决定第 4 章跳过逻辑)。

第 2 章:邮件分类(3 个问题) 基于第 1 章提出 5–7 个分类(新机会、活跃对话、需行动、财务、重要/个人、信息类、忽略/低优先级),确认是否匹配、是否缺失、哪个分类最耗时。生成 email-taxonomy.md,包含分类、信号(触发短语/发件人模式/主题标记)和每类默认操作。

第 3 章:回复风格与语调(6 个问题 + 样本请求) 了解正式程度、沟通禁忌、常用短语/落款、不同场景的人设、典型回复长度、硬性规则。关键步骤:请求用户粘贴 3–5 封真实已发送邮件作为样本,使用 scripts/voice_sample_analyzer.py 提取语音模式。生成 email-patterns.md。

第 4 章:评估框架(条件性) 仅当第 1 章出现机会邮件类别时运行。了解用户的第一直觉筛选、三个即时拒绝因素、三个即时兴趣因素、标准定价/条款、谈判姿态、VIP 发件人。生成 evaluation-framework.md,如有定价则同时生成 rate-card.md。

第 5 章:黑名单与模式(3 个问题) 了解始终跳过的发件人/域名、总是删除的邮件模式、浪费时间的公司/招聘者/通讯。生成 blocklist.md。

第 6 章:当前状态(3 个问题) 了解正在跟踪的活跃线程、逾期回复、有时间敏感截止日期的事项。生成 tracker.md 并创建空的 triage-log/ 目录。

第 7 章:报告偏好(3 个问题) 了解交付格式(邮件草稿/工作区文件/仅聊天摘要)、详细程度(30 秒扫描/详细分解/两者)、始终优先显示的内容。将偏好保存到 email-taxonomy.md 的 "Report Preferences" 章节。

第 8 章:确认与交接 列出所有已创建文件及一句话摘要,提示运行 inbox-triage 技能。提醒业务/定价/优先级变化时可重新运行。运行 scripts/kb_validator.py --workspace ${WORKSPACE} 确认 7 文件契约满足。

隐私边界

绝不在知识库文件中持久化密码、完整账号、SSN 或其他敏感凭证。如果用户在访谈中主动提供此类信息,予以确认但不存储;相关 KB 文件以 [stored separately by user] 替代。

重新运行行为

检测 ${WORKSPACE}/Email/,对每个已有文件询问:替换/合并/跳过。仅走用户选择更新的章节,跳过保留文件的章节。

错误处理

情况 行为
工作区不可访问 停止,告知用户文件将存放位置并请求权限/路径
用户拒绝分享样本 使用自我描述;在 patterns 文件中标记校准可能需要迭代
用户中途说 "skip this" 尊重;在文件中标记缺口为 [needs follow-up]
用户主动提供敏感信息 确认但不持久化;在文件中标记为 [stored separately by user]
在已有设置上重新运行 检测已有文件;逐文件询问:替换、合并、跳过
用户无定价/机会 完全跳过第 4 章;不创建空文件

可移植性

  • Claude Code CLI:原生支持,直接写入 markdown 文件到文件系统。
  • Claude.ai web:适用于项目文件/工件。替代路径:将文件生成为工件,指导用户保存到工作区,或使用已连接的文件系统(如可用)。

工具脚本

脚本 作用
scripts/kb_validator.py 验证 7 文件 KB 输出(必需文件存在、条件文件仅在其章节运行时存在、标题 + 结构正确)
scripts/section_progress_tracker.py JSON 支持的遍历状态,位于 ~/.inbox_setup_sessions/<session>.json,跟踪活跃章节、已回答问题、已提交文件
scripts/voice_sample_analyzer.py 从粘贴的已发送邮件样本中提取语音模式——开头短语、落款、长度分布、语域标记

参考资料

  • references/kb_file_contract.md — 规范的 7 文件契约(写入视角;镜像位于 inbox-triage/references/)
  • references/grill_me_section_walk.md — 8 章节纪律、跳过逻辑、逐章节提交
  • references/voice_calibration.md — 基于样本的语音提取理论 + 反模式

应拒绝的反模式

  • 一次性生成所有文件而非逐章节走
  • 一次性批量提问所有问题
  • 硬编码提供商引用(仅 Gmail 思维)
  • 在知识库中持久化敏感凭证
  • 跳过 "为什么这个问题重要" 的解释
  • 跳过语音样本请求(这是最高质量的输入)
  • 重新运行时未经同意覆盖已有文件
  • 在不适用时强制创建 rate-card.md 或 evaluation-framework.md

适用场景

  • 希望建立自动化收件箱分诊系统的用户
  • 需要个性化邮件分类和回复模板的个人或团队
  • 业务或优先级发生变化后需要更新邮件管理配置的用户

限制

  • 版本:1.0.0
  • 源规范:megaprompts/06-inbox-setup-megaprompt.md(维护者本地草稿规范——已 gitignore,不在公共仓库中)
  • 构建模式:Path B(直接转换)。与 inbox-triage 配对。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。