SuperAPI AI 工具集

kill-the-wall-of-text

办公与效率

查看项目

更新于 10-16 07:12

技能介绍

用途

该技能适用于工作成果即将从一个人传递给另一个人时:报告、计划、分析、备忘录、会议记录、研究、代码变更、提案等。每次原始工作必须交给未参与制作的人时使用。目标是产出一个接收者可在几秒内审阅、且发送者已阅读并签名的交互页面。

核心规则:像一位与五岁小孩说话的律师那样工作。律师为每个字签名并为其负责。没有人会给五岁小孩十页文字;有人会展示故事。

衡量标准:如果审阅时间比生成时间还长,工作就是劣质品。该技能反转这一比例——构建耗时更长,使审阅只需几秒。

主要能力

三层结构

每个页面都包含全部三层:

  • 顶部,10秒。一句话给出结论。请求事项:接收者必须做什么、何时完成。最多三个关键数字。
  • 正文,2分钟。以适合内容的形态呈现的交互视图。
  • 证据,按需展开。来源、方法、假设和被删内容。折叠起来。什么都不丢失,什么都不挡路。

顶部测试:如果接收者只读顶部就关闭页面,他们是否知道答案和下一步行动?

工作流程

  1. 阅读全部原始工作。提取接收者、请求事项、结论、每个事实及其在来源中的位置,以及缺口:缺失数据、矛盾、无证据的声明。
  2. 最多问两个问题,放在一条消息中。“谁接收这个,他们必须用它做什么?”和“他们必须理解的一件事是什么?”提供一个建议结论,让人可以回答是。不要问上下文已能回答的问题。被跳过的问题变成带标签的假设,而不是第二个问题。
  3. 选择形态。报告变成仪表盘。计划变成一页视图。决策变成选项对比。代码变更变成变更内容的图示。阅读 references/shape-table.md 了解十种形态以及两种形态都适用时的规则。
  4. 每个可见文字都用简化技术英语书写。短主动句,一词一义,不用习语,使用绝对日期,每个行动指定一个负责人。写作前阅读 references/writing-rules.md;其中还有保真规则以及两套规则相遇的情况。
  5. 快速发布第一版。从 references/page-skeleton.md 开始。第一版显示“Draft, not signed”横幅。聊天只发一行:“这是 V1。告诉我什么放顶部、删什么、哪里错了。”
  6. 每次发布前检查。阅读 references/pre-publish-check.md。其中有一个脚本,可找出违反写作规则的句子、计算阅读时间,并列出每个不在来源中的数字。
  7. 运行审阅循环。由人决定什么放顶部、删什么、哪里错了。每个区块有 Keep、Cut、Fix、Move up 控件,一个按钮把反馈复制为文本供聊天使用。把反馈应用到当前页面;不要重新构建。阅读 references/review-loop-and-signing.md。
  8. 获取签名。当人批准时,问一次:“你读完了全部内容,并为其负责吗?”回答是时,横幅变为“Signed by NAME, DATE”。没有签名,就没有变更。

references/worked-example.md 展示一个从原始工作到签名页面的案例,弱版本与好版本并列。

使用方式

该技能通过技能文件与参考文档驱动:references/shape-table.md、references/writing-rules.md、references/page-skeleton.md、references/pre-publish-check.md、references/review-loop-and-signing.md、references/worked-example.md。执行时先读取原始工作,提取要素,最多问两个问题,选择形态,按写作规则撰写,快速发布第一版,运行发布前检查,进入审阅循环,最后获取签名。

适用场景

  • 报告、计划、分析、备忘录、会议记录、研究、代码变更、提案等需要从一人传递给另一人的工作。
  • 需要接收者在几秒内完成审阅并明确下一步行动的场景。
  • 需要保留来源、方法、假设和被删内容,同时不干扰主视图的场景。

限制

  • 必须显示“Draft, not signed”横幅,直到人确认已完整阅读。
  • 必须把被删内容保留在证据层,供人恢复。
  • 必须在出现处标注每个假设、计算、提案、未验证声明和冲突。
  • 缺失的负责人、日期或数字必须写“Not in the source”。
  • 页面必须在手机上无横向滚动,打印时所有标签页展开。
  • 绝不编造数字、负责人、日期或引语。
  • 绝不写入人未给出的签名。
  • 绝不让声明比来源更强或更弱。
  • 顶部关键数字不超过三个,正文标签页不超过四个。
  • 绝不用长聊天消息或文本堆代替页面。
  • 绝不在未检查时声称已检查。

质量要点

最佳操作者从接收者的下一步行动出发,而不是从文档出发。第一个问题是“这个人读完后必须做什么?”形态、顶部和删减都由此决定。普通操作者从来源结构出发并保留它。

常见错误是“盒子里的文字”:同样的段落切成卡片,十二个数字同样大小。看起来更好,读起来并不更快。如果页面的形态就是来源的形态,工作就没有发生。

顶部陈述答案,而不是主题。“本季度未达计划 12%,小企业流失是原因”是顶部。“本报告涵盖季度表现”是标签。

阅读时间是页面上的一个数字。顶部加最长标签页,除以每分钟200词。超过三分钟意味着需要更多删减或更多折叠。

每个数字都有来源。不在来源中的数字带有 calculated 或 assumed 标签,否则就是错的。两个来源冲突时显示两个值,如果该数字在顶部,冲突也放顶部。

第一版约80%正确,这是计划。人修改的20%只有人知道:这个接收者会先问什么。好页面让这20%易于修改。人未做任何修改就签名的页面,是警告:人没有读。

交互要起作用。折叠隐藏深度。筛选回答问题。复选框记录行动。动画和悬停效果做不到这些。

聊天保持简短。每次发布后一行。页面是工作界面。