菜单
引导用户通过结构化的工作流程来协作撰写文档。当用户想要撰写文档、提案、技术规格说明、决策文档或类似的结构化内容时使用。这个工作流程帮助用户高效地传递上下文信息、通过迭代优化内容，并验证文档对读者是否有效。当用户提到撰写文档、创建提案、起草规格说明或类似的文档任务时触发。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/LeastBit/Claude_skills_zh-CN --skill doc-coauthoring命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | doc-coauthoring |
| description | 引导用户通过结构化的工作流程来协作撰写文档。当用户想要撰写文档、提案、技术规格说明、决策文档或类似的结构化内容时使用。这个工作流程帮助用户高效地传递上下文信息、通过迭代优化内容，并验证文档对读者是否有效。当用户提到撰写文档、创建提案、起草规格说明或类似的文档任务时触发。 |
此技能提供一个结构化的工作流程，用于引导用户进行协作式文档创建。作为积极的引导者，带领用户经历三个阶段：上下文收集、优化与结构化、以及读者测试。
触发条件：
初始提议： 向用户提供一个结构化的文档协作工作流程。解释三个阶段：
解释这种方法有助于确保文档在他人阅读时效果良好（包括当他们将其粘贴到 Claude 中时）。询问他们是否想尝试这个工作流程，或者更喜欢自由形式地工作。
如果用户拒绝，则自由形式地工作。如果用户接受，则进入第一阶段。
目标： 缩小用户所知与 Claude 所知之间的差距，为后续提供智能指导奠定基础。
首先询问用户关于文档的元信息：
告知他们可以用简短的方式回答，或者以任何对他们最方便的方式倾倒信息。
如果用户提供了模板或提到了文档类型：
如果用户提到编辑现有的共享文档：
一旦初始问题得到回答，鼓励用户倾倒他们拥有的所有上下文信息。请求以下信息：
建议他们不必担心组织信息——只需全部倾倒出来即可。提供多种方式来提供上下文：
如果有可用的集成（例如 Slack、Teams、Google Drive、SharePoint 或其他 MCP 服务器），提及这些可以用来直接拉取上下文信息。
如果没有检测到集成且在 Claude.ai 或 Claude 应用中： 建议他们可以在 Claude 设置中启用连接器，以便直接从消息应用和文档存储中拉取上下文。
告知他们在完成初始信息倾倒后会提出澄清性问题。
在上下文收集过程中：
如果用户提到团队频道或共享文档：
如果用户提到不熟悉的实体/项目：
随着用户提供上下文，跟踪已学到的内容和仍不清楚的内容
提出澄清性问题：
当用户表示已完成初始信息倾倒（或在提供了大量上下文之后），提出澄清性问题以确保理解：
根据上下文中的空白生成 5-10 个编号的问题。
告知他们可以用简短方式回答（例如"1: 是，2: 见 #频道，3: 不行因为向后兼容"），链接到更多文档，指向频道以供阅读，或者继续倾倒信息。以对他们最高效的方式为准。
退出条件： 当问题显示出理解时，就收集到了足够的上下文——当可以询问边缘情况和权衡而不需要解释基础知识时。
过渡： 询问他们在这个阶段是否还有更多上下文要提供，或者是否该开始起草文档了。
如果用户想要添加更多内容，让他们添加。准备好后，进入第二阶段。
目标： 通过头脑风暴、筛选和迭代优化，逐节构建文档。
给用户的说明： 解释将逐节构建文档。对于每个章节：
从未知最多的章节开始（通常是核心决策/提案），然后处理其余部分。
章节排序：
如果文档结构清晰： 询问他们想从哪个章节开始。
建议从未知最多的章节开始。对于决策文档，通常是核心提案。对于规格说明，通常是技术方案。摘要章节最好留到最后。
如果用户不知道需要哪些章节： 根据文档类型和模板，建议 3-5 个适合该文档类型的章节。
询问这个结构是否可行，或者他们是否想要调整。
一旦结构达成一致：
创建初始文档结构，所有章节使用占位符文本。
如果可以使用 artifacts：
使用 create_file 创建一个 artifact。这为 Claude 和用户提供了一个可以工作的框架。
告知他们将创建包含所有章节占位符的初始结构。
创建包含所有章节标题和简短占位符文本（如"[待撰写]"或"[此处填写内容]"）的 artifact。
提供框架链接并指出该填写每个章节了。
如果没有 artifacts 访问权限：
在工作目录中创建一个 markdown 文件。适当命名（例如 decision-doc.md、technical-spec.md）。
告知他们将创建包含所有章节占位符的初始结构。
创建包含所有章节标题和占位符文本的文件。
确认文件名已创建并指出该填写每个章节了。
对于每个章节：
宣布将开始处理 [章节名称] 章节。询问关于应包含内容的 5-10 个澄清性问题：
根据上下文和章节目的生成 5-10 个具体问题。
告知他们可以用简短方式回答，或者只需指出重要的内容。
对于 [章节名称] 章节，根据章节的复杂性头脑风暴 [5-20] 个可能包含的内容。寻找：
根据章节复杂性生成 5-20 个编号选项。最后，如果他们想要更多选项，提供继续头脑风暴的选择。
询问哪些要点应该保留、删除或合并。请求简短的理由以帮助了解下一章节的优先级。
提供示例：
如果用户给出自由形式的反馈（例如"看起来不错"或"我喜欢大部分但是..."）而不是编号选择，提取他们的偏好并继续。解析他们想要保留/删除/更改的内容并应用它。
根据他们选择的内容，询问 [章节名称] 章节是否遗漏了任何重要内容。
使用 str_replace 将该章节的占位符文本替换为实际起草的内容。
宣布将根据他们选择的内容起草 [章节名称] 章节。
如果使用 artifacts： 起草后，提供 artifact 的链接。
请他们阅读并指出要更改的内容。注意具体的反馈有助于为下一章节学习。
如果使用文件（没有 artifacts）： 起草后，确认完成。
告知他们 [章节名称] 章节已在 [文件名] 中起草完成。请他们阅读并指出要更改的内容。注意具体的反馈有助于为下一章节学习。
给用户的关键说明（在起草第一个章节时包含）： 提供说明：不要直接编辑文档，而是请他们指出要更改的内容。这有助于学习他们的风格以便用于后续章节。例如："删除 X 要点 - Y 已经涵盖了"或"让第三段更简洁"。
当用户提供反馈时：
str_replace 进行编辑（永远不要重新打印整个文档）继续迭代 直到用户对该章节满意。
在连续 3 次迭代没有实质性更改后，询问是否有任何内容可以在不丢失重要信息的情况下删除。
当章节完成时，确认 [章节名称] 已完成。询问是否准备好进入下一章节。
对所有章节重复此过程。
当接近完成（80% 以上的章节完成）时，宣布打算重新阅读整个文档并检查：
阅读整个文档并提供反馈。
当所有章节都已起草和优化： 宣布所有章节都已起草。表示打算再次审阅完整的文档。
审阅整体连贯性、流畅性、完整性。
提供任何最终建议。
询问是否准备好进入读者测试，或者他们是否想要优化其他内容。
目标： 用一个全新的 Claude（无上下文污染）测试文档，验证它对读者是否有效。
给用户的说明： 解释现在将进行测试，看看文档是否真正对读者有效。这可以发现盲点——对作者来说有意义但可能让其他人困惑的内容。
如果可以使用子代理（例如在 Claude Code 中）：
直接执行测试，无需用户参与。
宣布打算预测读者在试图发现这份文档时可能会问什么问题。
生成读者可能实际会问的 5-10 个问题。
宣布将用一个全新的 Claude 实例（没有这次对话的上下文）测试这些问题。
对于每个问题，只用文档内容和问题调用一个子代理。
总结读者 Claude 对每个问题的正确/错误之处。
宣布将执行额外检查。
调用子代理检查歧义、错误假设、矛盾。
总结发现的任何问题。
如果发现问题： 报告读者 Claude 在特定问题上遇到困难。
列出具体问题。
表示打算修复这些空白。
返回到有问题的章节进行优化。
如果没有子代理访问权限（例如 claude.ai 网页界面）：
用户需要手动进行测试。
询问人们在试图发现这份文档时可能会问什么问题。他们会在 Claude.ai 中输入什么？
生成读者可能实际会问的 5-10 个问题。
提供测试说明：
对于每个问题，指示读者 Claude 提供：
检查读者 Claude 是否给出正确答案或是否误解了什么。
还要问读者 Claude：
询问读者 Claude 答错了什么或在哪里遇到困难。表示打算修复这些空白。
返回到有问题的章节进行优化。
当读者 Claude 能够一致地正确回答问题，且没有发现新的空白或歧义时，文档就准备好了。
当读者测试通过时： 宣布文档已通过读者 Claude 测试。在完成之前：
询问他们是否想要再次审阅，或者工作是否完成。
如果用户想要最终审阅，则提供。否则： 宣布文档完成。提供一些最终提示：
语气：
处理偏离：
上下文管理：
Artifact 管理：
create_file 起草完整章节str_replace 进行所有编辑质量优先于速度：