Agent Skills
返回列表
✍️

文档协同创作

内容创作 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/cn-doc-coauthoring。

技能介绍

要解决的具体写作问题

写 PRD、RFC 或决策文档时,卡点通常不是排版,而是上下文散落在聊天记录、旧文档、口头决策和架构讨论里。作者知道背景,但文档仍可能漏掉边界条件、隐含假设和读者真正会问的问题。这个技能把文档创作拆成三个阶段:先收集未说清的前提,再逐章节精炼,最后用读者视角验证表达是否成立。

技能如何工作

  • 上下文收集:先确认文档类型、受众、预期影响、模板和约束,再鼓励用户进行信息倾倒,覆盖项目背景、替代方案、团队约束、架构依赖、时间压力和利益相关者顾虑。若共享文档、消息平台或 MCP 集成可用,它会建议直接拉取上下文,而不是让用户反复复制粘贴。
  • 精炼与结构:按章节推进,优先从未知数最多的核心提案或技术方法开始。每一章会经历澄清问题、头脑风暴 5-20 个候选点、用户选择保留/删除/合并、起草和迭代编辑。资料中强调使用 str_replace 做局部修改,避免每次重印整篇文档。
  • 读者测试:用新的 Claude 实例或子智能体只依据文档回答 5-10 个读者问题,检查歧义、错误假设、矛盾和填充式内容。若环境不支持子智能体,则给出手动测试路径:打开新对话,粘贴文档,再向读者模型提问。

适用边界与注意点

它更适合需要持续对齐的长篇工程文档,而不是单段短说明。若用户拒绝结构化流程,它会退回自由写作;若缺少共享文档权限或连接器,上下文拉取和读者测试会退化为手动粘贴。最终的事实、链接和技术细节仍由作者负责复核。

使用场景

  • 写 PRD 时,收集项目背景、模板和利益相关者顾虑,再按章节起草。
  • 起草决策文档时,从核心提案开始,筛选候选要点并局部迭代。
  • 评审共享规格前,用读者问题检查歧义、隐含假设和内部矛盾。
  • 从 Slack 或 Drive 拉取上下文,补齐缺失背景后再起草文档。

适合人员

  • 需要写 RFC 的工程师:要把技术背景、权衡和读者疑问整理成可评审文档。
  • 负责产品规格的产品经理:要收集利益相关者约束并输出结构化 PRD。
  • 需要沉淀决策的技术负责人:要把讨论、替代方案和最终理由写成决策文档。
  • 要跨团队共享设计文档的架构师:要从共享资料补齐上下文并检查读者理解。