doc-coauthoring
使用结构化AI指导共创文档
也可从以下获取: 7Spade,7Spade,davila7,AstraBit-CPT,Azeem-2,ZhanlinCui,anthropics
创建高质量文档需要迭代和新鲜视角。本技能提供了一个经过验证的三阶段工作流程,将模糊的想法转化为经过读者测试的清晰文档。
下载技能 ZIP
在 Claude 中上传
前往 设置 → 功能 → 技能 → 上传技能
开启并开始使用
测试它
正在使用“doc-coauthoring”。 User wants to write a design doc for a new caching layer
预期结果:
结构化工作流程从关于缓存问题、受众和约束的上下文问题开始。在信息倾泻和澄清问题之后,文档逐步构建(问题陈述、考虑的备选方案、建议的方法、实施计划),并通过迭代完善。读者测试验证文档在团队审查前能捕捉到关键问题。
正在使用“doc-coauthoring”。 User has a draft RFC that feels incomplete
预期结果:
工作流程通过有针对性的问题识别差距,为每个部分集思广益缺失的考虑因素,并生成完善的RFC。读者测试使用新的Claude实例发现歧义,然后在最终发布前解决这些问题。
安全审计
安全All static analysis findings are false positives. The 'external_commands' references are Claude Code tool calls (create_file, str_replace), not shell execution. The 'network' reference is documentation text directing users to claude.ai, not actual network calls. Cryptographic and reconnaissance patterns are text matches in documentation context only. This is a pure instructional skill with no executable security risks.
质量评分
你能构建什么
技术规范编写
工程师可以使用此工作流程系统地捕获需求、探索备选方案,并生成 anticipating 实现问题的读者就绪文档。
设计决策文档
记录架构决策的团队受益于结构化方法,该方法捕获上下文、探索权衡,并通过读者测试验证清晰度。
产品需求和提案
产品团队可以通过遵循上下文收集、完善和测试阶段将粗略的想法转化为完善的PRD,确保输出可供利益相关者使用。
试试这些提示
I need to write a technical specification for a new feature. Can you guide me through the documentation co-authoring workflow?
I have an existing design doc that needs improvement. Let's use the co-authoring workflow to refine it section by section.
My document is mostly complete. Let's do the reader testing stage to find gaps before I share it with the team.
I need to create a proposal document from scratch. Guide me through all three stages: context gathering, refinement and structure, and reader testing.
最佳实践
- 完成所有三个阶段,不要跳过——每个阶段都能发现不同类型的问题
- 在第1阶段提供充分的上下文,以便在后续阶段获得更好的指导
- 使用读者测试反馈来识别真正的差距,而不是维护现有内容
- 每次改进一个部分,而不是进行广泛的改写
- 忽视读者测试反馈,因为内容对作者来说似乎很明显
避免
- 跳过上下文收集直接跳到起草会导致文档不完整
- 进行广泛的改写而不是精细的逐部分完善
- 忽视读者测试反馈,因为内容对作者来说似乎很明显