一份操作文档是否可用,不能只看标题齐不齐、措辞是否正式。新同事能否照着完成工作,遇到异常知道交给谁,往往更能说明问题。Doc Co-Authoring Skill 的实用之处,是把背景收集、逐节修改与读者检验组织成一个协作流程,让文档缺少的条件尽早暴露。
本文使用 Anthropic 官方仓库的 doc-coauthoring 示例技能,围绕虚构共享工作室的设备借用流程,整理一份可检查的 SOP。最终交付包括正文、待确认项与读者问题清单。它不需要部署服务器,也不依赖 Word 自动排版。示例草稿和参考答案为本站编写,没有冒称已通过模型或真实读者测试。
一、了解这个 Skill 的定位
该技能主要帮助协作撰写文档、方案、技术说明和决策材料。核心说明位于 skills/doc-coauthoring/SKILL.md,采用收集上下文、细化结构与读者检验三个阶段。它不是文档内容的事实来源,也不会知道你单位没有提供的管理规定。
如果已有一份明确模板,先保留模板要求;如果只是需要改几句话,也不必机械走完所有阶段。技能负责引导讨论,使用者仍要确认业务事实、参与范围和最终发布版本。
本页下载沿用已核验的 Anthropic 完整源码包,目标目录为 skills/doc-coauthoring,版本按项目资料表展示。核对时该目录未单列独立 LICENSE 文件,因此不把其他技能目录的 Apache 许可直接套用到这里;具体使用与再分发条件应查看原项目说明。本文原创练习正文不属于该技能源码。
二、安装示例插件,再准备空白文档
使用 Claude Code 时,按官方仓库 README 在交互界面添加市场、安装示例技能插件。注意下面是 Claude Code 内的命令,不是在系统终端直接运行:
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills按工具提示启用,之后在任务中明确提到 doc-coauthoring。其他宿主需要遵循自己的技能加载方式;不要把下载的文件夹随意覆盖到现有配置。无法看到技能时,先核对插件是否启用与目标目录是否完整,再按官方说明检查会话加载。
创建 equipment-sop.md 保存正文,同时创建 open-questions.md 存放尚未确认的事项。为了做本练习,只需支持文本读写的工具。没有连接企业网盘或聊天系统,也可以直接粘贴下列虚构事实,不必为了写文档授予无关资料访问权限。
三、先给事实,再让技能指出空白
虚构工作室有三套阅读灯,用编号 L01、L02、L03 管理。管理员是“值班管理员”,借用者是“已登记成员”。只允许在工作室内使用,最长借用一天,必须当天归还。管理员现场核对设备编号与配件,双方完成借出或归还登记。
如果发现设备损坏,借用者应停止使用并交给值班管理员登记,不自行维修。本文没有制定赔偿金额,也没有提供逾期处罚。登记表只记录成员编号、设备编号、借出时间、约定归还时间、归还时间和异常说明,不要求填手机号或家庭住址。
把这些信息原样提供给技能,再提出任务:
请使用 doc-coauthoring,协作撰写设备借用 SOP。
读者:第一次参与值班的成员与首次借用的人。
目标:能按文档完成借出、归还与异常登记。
范围:只使用我给出的虚构事实,不新增罚款、审批层级或赔偿承诺。
先列出已知条件和需要确认的问题,暂不写完整正文。
未提供的信息放入 open-questions.md,不填入可执行步骤。
文档面向共享工作室,不涉及企业真实人员资料。例如“当天最晚几点归还”“是否可代还”“登记工具暂时不可用怎么办”,都属于现有材料没有回答的问题。可以把它们列入待确认,不能靠所谓常规制度自动补成“晚十点前归还”或“代还一律罚款”。
四、把文档拆成读者需要完成的动作
建议使用五部分:适用范围与角色、借出前检查、借出登记、归还检查、异常处理。开头说明设备只在工作室内使用、须当日归还;后面按实际动作组织,避免把所有规则塞进一段长篇概述。
每一节检查四件事:谁来做、拿什么做、具体做什么、怎样确认完成。例如“按规定登记”不够具体,应说明值班管理员核对设备编号与配件,并记录成员编号、借出时间及约定归还时间,再由双方确认。
可以先写最容易遗漏的异常流程,再回到正常借还。因为正常流程看起来顺畅,并不意味着设备损坏、编号不清楚或登记缺项时也能执行。先解决流程空白,再润色句子。
逐节修改时只处理一组问题,例如本轮补齐归还检查,下一轮再统一术语。若一次同时改角色、范围和登记字段,后面很难知道哪处修改导致了前后不一致。
五、一段可核对的正文参考
以下片段由本站按给定材料人工整理,可放入自己的草稿中核对结构,不是模型已经执行过的操作记录。
借出前
- 借用者确认自己为已登记成员,并选择需要借用的阅读灯。
- 值班管理员与借用者现场核对设备编号和配件。
- 发现损坏时停止借出,交由值班管理员登记异常,不自行维修。
借出登记
- 记录成员编号、设备编号、借出时间和约定归还时间。
- 约定归还时间不得超过当天;本练习没有提供具体闭馆时间,需要另行确认。
- 双方确认登记内容;设备只可在工作室内使用。
归还与异常
- 值班管理员与借用者现场核对归还设备编号及配件。
- 记录归还时间;如发现损坏,停止使用并记录异常说明。
- 将异常设备交由值班管理员处理,不在本文中自行决定维修方式或赔偿金额。
这里保留了一个影响正式执行的空白:具体闭馆时间。教学草稿可以明确标注,正式发布前应由管理方确认并补齐。不能把“材料不足”藏起来,再宣称文档已经适合所有值班场景。
六、让没有参与写作的人只看正文
协作文档的读者检验,重点是检查正文能否独立传达信息。请一位没参与整理的人只读正文,不给他看你与 AI 的聊天记录。也可以在新的 AI 会话中只粘贴正文辅助找空白,但模型评审不能替代真实业务责任人的确认。
本例可问五个问题:谁能借设备?设备能否带离工作室?借出要记录哪些字段?归还发现损坏应交给谁?具体最晚几点归还?按当前草稿,前四题应能找到依据,第五题应指出尚未提供具体时间,而不是猜一个数字。
参考答案是:已登记成员;不能带离工作室;记录成员编号、设备编号、借出时间与约定归还时间;交值班管理员登记处理;具体闭馆时间待确认。这个答案清单是人工核对依据,不代表已经做过独立读者测试。
如果读者问“管理员是哪个人”,需要判断文档是否面向有值班安排的环境。若安排表本身也不存在,应补上可找到管理员的方式;若有现行值班表,可以明确引用。不能指望第一次值班的人自动了解隐藏背景。
七、修改完成后再检查发布条件
收集问题时记录原句、误解、原因和拟改内容,不要只写“读者没看懂”。若把借出登记与归还登记混淆,就改步骤顺序与字段说明;若设备编号位置不清楚,应补充实际设备上的定位信息,不能只把句子改得更正式。
全部关键空白解决后,再统一术语、标题和格式,检查正文是否引用了不存在的表单,链接是否可访问,附件是否真的已提供。涉及照片时写清图片表达的检查点,不能让图成为文字无法解释的黑箱。
最终交付包括已确认正文、版本号、变更摘要、未关闭问题和负责人确认状态。如果仍有影响执行的问题,保留“待确认草稿”标识,不把它发成正式制度。SOP 是供别人按步骤使用的工作资料,成稿质量取决于信息是否完整、步骤是否清楚、责任是否能落实。
来源与项目资料
本文设备、角色、字段、草稿与问题清单均为原创虚构练习。没有访问企业内部资料,也没有运行下载包内代码;更多协作写作方法见 Skill 资源库。

还没有公开评论,欢迎分享你的想法。