跳到主要内容
哒哒星球DADA PLANET

Skill · 已公开版本

doc-coauthoring · 先补齐背景,再把文档写给真正的读者

通过背景收集、结构迭代和读者检验共同完成提案、说明或决策文档,找出作者以为读者已经知道的内容。

先看看示例

作者提供的示例,实际效果取决于你的输入和使用工具。

输入

已知:大文件同步导出会超时;异步队列已有基础设施;用户接受稍后下载;尚不知保存时长。

输出

编辑示例 · 未运行
建议:将大文件导出改为异步任务,小文件路径暂保持现状。

理由:现有超时发生在请求等待阶段,队列基础设施可复用。

用户变化:提交后看到任务状态,完成后下载;失败需明确可重试。

待决事项:结果文件保存多久、谁能下载、失败重试次数。

读者检验问题:如果导出失败,用户是否知道该做什么?本文尚需补状态与权限说明后再定稿。

方法说明

通过背景收集、结构迭代和读者检验共同完成提案、说明或决策文档,找出作者以为读者已经知道的内容。

具体任务

先补背景再共写决策文档:明确读者、目的和约束,逐节组织已有材料。

用读者问题检查文档能否独立理解:让没有会话背景的读者检验遗漏、歧义与论证跳步。

必需材料

文档目的和目标读者

已有材料、约束与希望读者作出的决定

可选材料

组织模板

现有草稿与反对意见

使用门槛

用户能补充独有背景,文档事实与待决事项可区分。

这个 Skill 额外提供的方法

把“写得顺”进一步检验成“读者能据此判断与行动”。

编辑示例(未运行)

写清是否把导出任务改为异步

任务:给技术决策文档补一段可审阅的建议。

输入:
已知:大文件同步导出会超时;异步队列已有基础设施;用户接受稍后下载;尚不知保存时长。

结果片段:
建议:将大文件导出改为异步任务,小文件路径暂保持现状。

理由:现有超时发生在请求等待阶段,队列基础设施可复用。

用户变化:提交后看到任务状态,完成后下载;失败需明确可重试。

待决事项:结果文件保存多久、谁能下载、失败重试次数。

读者检验问题:如果导出失败,用户是否知道该做什么?本文尚需补状态与权限说明后再定稿。

草稿包含论证与未决问题,读者问题直接暴露文档缺口。 此为编辑示例,未安装或运行上游 Skill。

首次任务

与我共写【目的/读者】文档,材料【已有内容/约束】,需要决定【事项】;验收:逐节有依据,读者能独立理解,未决问题和责任明确。
必需材料:文档目的和目标读者:【请填写或粘贴】;已有材料、约束与希望读者作出的决定:【请填写或粘贴】

验收方法

正文是否包含读者所需背景

建议是否由材料支持且回应反对意见

独立阅读能否回答关键决策问题

依赖与准备

文本读写与可选文件工具;独立读者测试可人工完成,代理需宿主支持和授权。

使用边界

这是协作写作流程,不自动替作者作决策或发布。

读者测试是否使用独立上下文或代理取决于宿主能力和授权。

排错

反复润色却一直缺关键信息:暂停句子优化,列出影响决定的背景缺口并补材料。

只有作者自己看得懂缩写:通过读者问题检查,将首次出现的术语与前提写清。

固定来源

https://github.com/anthropics/skills/blob/33375500bcea98d610eb30ce10ac4e59b89c390d/skills/doc-coauthoring/SKILL.md