SuperAPI AI 工具集

doc-coauthoring

写作与研究

查看项目

更新于 10-16 03:42

技能介绍

用途:为协作撰写文档提供结构化工作流。当用户提到写文档、草拟提案、创建规格或 PRD、设计文档、决策文档、RFC,或似乎要开始一项较大的写作任务时,可主动提出该流程。流程分三阶段,用户可拒绝并改用自由写作。

阶段一 背景收集:先问文档类型、目标读者、期望效果、模板格式与其它约束;鼓励用户一次性倾倒背景,如项目缘由、团队讨论、替代方案、组织背景、时间压力、技术架构、相关方关切,支持以要点或链接方式提供。如可用集成(如 Slack、Teams、Google Drive、SharePoint、MCP 服务器),可拉取上下文;未检测到集成时,建议在设置中启用连接器或直接粘贴内容。之后提出 5-10 个澄清问题。当能就边界情况与取舍提问而无需解释基础时,即可进入下一阶段。

阶段二 细化与结构:逐节构建。每节先问 5-10 个澄清问题,再头脑风暴 5-20 个候选要点,用户选择保留、删除或合并,随后补缺、起草并用 str_replace 做细粒度修改。通常从未知最多的节开始(决策文档为核心提案,规格为技术方案),摘要留到最后。若有 artifacts 权限,用 create_file 生成含占位符的文档骨架并每次修改后给出链接;否则在工作目录创建 markdown 文件。连续 3 轮无实质修改时,询问是否有可删内容。接近完成时通读全文检查流畅度、冗余、矛盾与空泛表述。

阶段三 读者测试:用无上下文的 Claude 验证文档能否被读者理解。若有子代理(如 Claude Code),先预测 5-10 个读者可能问题,用子代理仅凭文档内容回答,再额外检查歧义、错误假设与矛盾并汇报修复。若无子代理(如网页版),用户需手动测试:新建对话 https://claude.ai,粘贴文档并提问,同时问“文档中哪些内容可能含糊”“预设了哪些读者已知知识”“是否存在内部矛盾”,根据结果回到细化阶段修正。当读者 Claude 能稳定正确回答且不再暴露新缺口时通过。最后建议用户自行通读、核验事实与链接,并可将本次对话链接附于附录。

限制:实际整合能力、子代理与 artifacts 是否可用取决于运行环境;资料未提供具体收费、价格或平台支持范围。