技能包

doc-coauthoring:按三阶段一起写结构化文档

适合要写文档、提案、技术规格或决策备忘的人,须从收集上下文开始,并在别人阅读前用无上下文的新会话做读者测试。

官方来源 · doc-coauthoring

安装

Act as an active guide through Context Gathering, Refinement and Reader Testing

适合谁

doc-coauthoring 面向要写结构化文本的人:文档、提案、技术规格、决策备忘,或同类内容。它不是自动交稿工具,而是主动带着你走完三个阶段:Context Gathering(收集上下文)、Refinement & Structure(打磨与结构)、Reader Testing(读者测试)。

触发条件写得很直接:当你提到写文档、做提案、起草规格或类似任务时使用。若你只是想随便聊两句、不接受分阶段引导,说明允许你拒绝这套结构、改走自由发挥;但一旦接受,就应按阶段推进,而不是跳到成稿。

它不适合当安装器。说明没有给出任何安装命令,也没有写把它放到某个目录就算可用。若当前助手还不能按这套三阶段工作,现有说明到此为止,不要从页面地址反推安装路径。它也不适合在没有读者测试的情况下,把第一稿直接发给别人。

3 分钟完成第一次尝试

官方第一次路径是开始共写,而不是安装。说明页是 https://raw.githubusercontent.com/anthropics/skills/main/skills/doc-coauthoring/SKILL.md 请只按这一页的阶段做。不要编写未出现的安装句。

前置条件:当前助手已经能按 doc-coauthoring 的步骤引导,并且你手头有一个低风险题目,例如一页对内的决策备忘草稿。没有安装命令,因此“位置”就是这次对话,而不是某个推测出来的技能目录。

低风险第一次任务:明确说出“我要写一份决策备忘”,接受三阶段引导,但只走完 Context Gathering。先回答助手关于读者、目的和已知材料的问题,不要急着生成全文,更不要对外发送。若助手提到 Slack、Teams、Google Drive、SharePoint 或其它 MCP 可用来直接拉取上下文,先确认这些集成在你这边是否真的可用;不可用就改用粘贴或口述,不要假装已经接通。

成功信号是助手表明自己会按三个阶段带你走,并开始收集上下文,而不是直接吐出一篇完整文档。收集阶段结束前,不要批准大段写入文件。说明没有写必须使用哪个编辑器,也没有写文件格式。

使用案例

案例一:按三阶段共写一份规格或提案。当你提到写文档、做提案或起草规格时启动,助手充当主动向导:先收集上下文,再打磨结构和表述。适合你已经有素材、但需要有人按阶段追问缺口的时候。说明没有给出每阶段的问题清单,因此只能做到“接受引导并逐段确认”。若助手跳过收集直接成稿,应要求回到 Context Gathering。说明页仍是 https://raw.githubusercontent.com/anthropics/skills/main/skills/doc-coauthoring/SKILL.md

案例二:成稿前做读者测试。第三阶段是用一个没有上下文的新 Claude 去读这篇文档,抓住盲点,再让别人读。这适合你觉得自己写得太顺、担心外人看不懂的时候。说明没有写如何一键开启新会话,也没有写测试问题模板;因此只能做到“另开无上下文会话,把文档贴过去看对方能否复述要点”。测试未完成前,不要把文档当作已就绪。若集成可用,可用来拉上下文,但不能代替读者测试。

使用边界

没有安装命令:说明只定义技能身份和三阶段流程,不能把页面路径当成安装器。触发边界:用于写文档、提案、规格或同类结构化内容;其它写作任务没有被点名。流程边界:三个阶段是收集上下文、打磨与结构、读者测试;读者测试必须用无上下文的新 Claude。集成边界:Slack、Teams、Google Drive、SharePoint 或其它 MCP 只有在“可用”时才能用来拉上下文,说明没有保证这些集成一定存在,也没有写启用步骤。拒绝引导时可以改自由发挥,但不要把自由发挥误当成已经做完读者测试。