先看看示例
作者提供的示例,实际效果取决于你的输入和使用工具。
输入
已知:大文件同步导出会超时;异步队列已有基础设施;用户接受稍后下载;尚不知保存时长。
输出
编辑示例 · 未运行
建议:将大文件导出改为异步任务,小文件路径暂保持现状。
理由:现有超时发生在请求等待阶段,队列基础设施可复用。
用户变化:提交后看到任务状态,完成后下载;失败需明确可重试。
待决事项:结果文件保存多久、谁能下载、失败重试次数。
读者检验问题:如果导出失败,用户是否知道该做什么?本文尚需补状态与权限说明后再定稿。
方法说明
通过背景收集、结构迭代和读者检验共同完成提案、说明或决策文档,找出作者以为读者已经知道的内容。 具体任务 先补背景再共写决策文档:明确读者、目的和约束,逐节组织已有材料。 用读者问题检查文档能否独立理解:让没有会话背景的读者检验遗漏、歧义与论证跳步。 必需材料 文档目的和目标读者 已有材料、约束与希望读者作出的决定 可选材料 组织模板 现有草稿与反对意见 使用门槛 用户能补充独有背景,文档事实与待决事项可区分。 这个 Skill 额外提供的方法 把“写得顺”进一步检验成“读者能据此判断与行动”。 编辑示例(未运行) 写清是否把导出任务改为异步 任务:给技术决策文档补一段可审阅的建议。 输入: 已知:大文件同步导出会超时;异步队列已有基础设施;用户接受稍后下载;尚不知保存时长。 结果片段: 建议:将大文件导出改为异步任务,小文件路径暂保持现状。 理由:现有超时发生在请求等待阶段,队列基础设施可复用。 用户变化:提交后看到任务状态,完成后下载;失败需明确可重试。 待决事项:结果文件保存多久、谁能下载、失败重试次数。 读者检验问题:如果导出失败,用户是否知道该做什么?本文尚需补状态与权限说明后再定稿。 草稿包含论证与未决问题,读者问题直接暴露文档缺口。 此为编辑示例,未安装或运行上游 Skill。 首次任务 与我共写【目的/读者】文档,材料【已有内容/约束】,需要决定【事项】;验收:逐节有依据,读者能独立理解,未决问题和责任明确。 必需材料:文档目的和目标读者:【请填写或粘贴】;已有材料、约束与希望读者作出的决定:【请填写或粘贴】 验收方法 正文是否包含读者所需背景 建议是否由材料支持且回应反对意见 独立阅读能否回答关键决策问题 依赖与准备 文本读写与可选文件工具;独立读者测试可人工完成,代理需宿主支持和授权。 使用边界 这是协作写作流程,不自动替作者作决策或发布。 读者测试是否使用独立上下文或代理取决于宿主能力和授权。 排错 反复润色却一直缺关键信息:暂停句子优化,列出影响决定的背景缺口并补材料。 只有作者自己看得懂缩写:通过读者问题检查,将首次出现的术语与前提写清。 固定来源 https://github.com/anthropics/skills/blob/33375500bcea98d610eb30ce10ac4e59b89c390d/skills/doc-coauthoring/SKILL.md