文档协同创作

📌 Skill基础信息

技能名称：doc-coauthoring（文档协同创作）

技能简称：文档协同

来源：社区第三方（ComeOnOliver/skillshub）

运行宿主：Claude AI 平台（包括 Claude.ai 网页端和 Claude 应用）

核心定位：通过结构化工作流引导用户完成技术文档、提案、技术规范和决策文档的协同创作，确保文档质量与读者友好性。

🧩 内部核心组成

核心能力模块

三阶段工作流引擎：上下文收集 → 精炼与结构化 → 读者测试
智能问答系统：动态生成澄清问题，识别信息缺口
文档脚手架生成：自动创建带占位符的文档结构
迭代式精炼机制：基于用户反馈进行精准内容调整
读者视角测试：使用无上下文子代理验证文档效果

集成工具与命令

类型	名称	功能简述
文件操作	create_file	创建文档脚手架和占位结构
内容编辑	str_replace	精准替换文档内容，避免全文重写
集成支持	第三方连接器	接入 Slack、Teams、Google Drive 等平台

目录结构

标准 Markdown 文档生成（如 decision-doc.md, technical-spec.md）
artifacts 系统集成（当可用时）
模板化章节结构

🛠 安装与启用方式

安装命令：

skills install --user ComeOnOliver/skillshub

前置依赖：

Claude AI 平台访问权限
可选：第三方连接器（Slack、Teams、Google Drive等）用于上下文收集

启用方式：

在 Claude 对话中触发相关关键词（"write a doc", "draft a proposal"等）
技能自动识别文档创作场景并提供结构化工作流选项

📋 标准工作流

触发检测：用户提及文档创作任务时，技能自动提供结构化工作流选项

阶段一：上下文收集

- 收集文档元信息（类型、受众、目标等）

- 鼓励用户信息倾泻（info dumping）

- 生成5-10个澄清问题填补认知缺口

- 集成第三方平台获取相关文档和讨论内容

阶段二：精炼与结构化

- 创建文档脚手架（章节结构和占位符）

- 按章节迭代创作：澄清问题 → 脑暴选项 → 内容筛选 → 起草 → 精炼

- 使用 str_replace 进行精准编辑，避免全文重写

- 完成所有章节后进行整体连贯性检查

阶段三：读者测试

- 有子代理环境：自动创建无上下文Claude实例测试文档效果

- 无子代理环境：指导用户手动在新会话中测试文档

- 识别盲点和模糊处，返回阶段二进行修复

⚠️ 关键限制、缺陷、注意事项

平台限制：

仅能在 Claude AI 平台运行，不支持其他Agent工具
子代理测试功能需要 Claude Code 环境支持
网页端 Claude.ai 需要手动进行读者测试

Token消耗：

多轮迭代工作流会产生较高token消耗
文档长度和修改次数直接影响使用成本

适用项目类型：

✔️ 技术规范、设计文档、决策文档
✔️ 项目提案、RFC文档
✔️ 需要多方协作的结构化文档

不适用场景：

❌ 简短的非正式文档
❌ 不需要严格结构的创意写作
❌ 实时协作编辑（非迭代式工作流）

生产环境适用性：

适合预生产环境的文档创作
需要人工审核最终输出内容
第三方集成依赖连接器配置稳定性

✅ 适用场景 & ❌ 不适合场景

适合使用：

技术团队编写技术规范和设计文档
产品经理创作产品需求文档(PRD)
架构师起草系统架构决策文档
需要多人评审和迭代的重要文档
希望确保文档读者友好性的场景

不适合使用：

简单的个人笔记或备忘录
非结构化的创意写作任务
紧急的即时文档需求（工作流较长）
不需要深度协作的单人文档创作
已有成熟文档模板和流程的团队

如何安装

skills install --user ComeOnOliver/skillshub

通用安装教程：在哪里输入上面的命令

上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：

打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
把上面的安装命令复制进去，回车运行，等待下载与注册完成。
重启或重新加载 AI 工具，让新安装的 Skill 被识别。
新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。

Claude 桌面版（macOS / Windows）

桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。

Claude Code（终端 CLI）

直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。

VS Code（含 GitHub Copilot）

打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。

Cursor

底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。

Windsurf

底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。

其他工具（ChatGPT、本地脚本等）

不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。

风险提示

✅ 低风险

自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。