用途
该技能适用于工作成果即将从一个人传递给另一个人时:报告、计划、分析、备忘录、会议记录、研究、代码变更、提案等。每次原始工作必须交给未参与制作的人时使用。目标是产出一个接收者可在几秒内审阅、且发送者已阅读并签名的交互页面。
核心规则:像一位与五岁小孩说话的律师那样工作。律师为每个字签名并为其负责。没有人会给五岁小孩十页文字;有人会展示故事。
衡量标准:如果审阅时间比生成时间还长,工作就是劣质品。该技能反转这一比例——构建耗时更长,使审阅只需几秒。
主要能力
三层结构
每个页面都包含全部三层:
- 顶部,10秒。一句话给出结论。请求事项:接收者必须做什么、何时完成。最多三个关键数字。
- 正文,2分钟。以适合内容的形态呈现的交互视图。
- 证据,按需展开。来源、方法、假设和被删内容。折叠起来。什么都不丢失,什么都不挡路。
顶部测试:如果接收者只读顶部就关闭页面,他们是否知道答案和下一步行动?
工作流程
- 阅读全部原始工作。提取接收者、请求事项、结论、每个事实及其在来源中的位置,以及缺口:缺失数据、矛盾、无证据的声明。
- 最多问两个问题,放在一条消息中。“谁接收这个,他们必须用它做什么?”和“他们必须理解的一件事是什么?”提供一个建议结论,让人可以回答是。不要问上下文已能回答的问题。被跳过的问题变成带标签的假设,而不是第二个问题。
- 选择形态。报告变成仪表盘。计划变成一页视图。决策变成选项对比。代码变更变成变更内容的图示。阅读 references/shape-table.md 了解十种形态以及两种形态都适用时的规则。
- 每个可见文字都用简化技术英语书写。短主动句,一词一义,不用习语,使用绝对日期,每个行动指定一个负责人。写作前阅读 references/writing-rules.md;其中还有保真规则以及两套规则相遇的情况。
- 快速发布第一版。从 references/page-skeleton.md 开始。第一版显示“Draft, not signed”横幅。聊天只发一行:“这是 V1。告诉我什么放顶部、删什么、哪里错了。”
- 每次发布前检查。阅读 references/pre-publish-check.md。其中有一个脚本,可找出违反写作规则的句子、计算阅读时间,并列出每个不在来源中的数字。
- 运行审阅循环。由人决定什么放顶部、删什么、哪里错了。每个区块有 Keep、Cut、Fix、Move up 控件,一个按钮把反馈复制为文本供聊天使用。把反馈应用到当前页面;不要重新构建。阅读 references/review-loop-and-signing.md。
- 获取签名。当人批准时,问一次:“你读完了全部内容,并为其负责吗?”回答是时,横幅变为“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%易于修改。人未做任何修改就签名的页面,是警告:人没有读。
交互要起作用。折叠隐藏深度。筛选回答问题。复选框记录行动。动画和悬停效果做不到这些。
聊天保持简短。每次发布后一行。页面是工作界面。