技能 doc-coauthoring
📦

doc-coauthoring

安全

使用结构化AI指导共创文档

也可从以下获取: 7Spade,7Spade,davila7,AstraBit-CPT,Azeem-2,ZhanlinCui,anthropics

创建高质量文档需要迭代和新鲜视角。本技能提供了一个经过验证的三阶段工作流程,将模糊的想法转化为经过读者测试的清晰文档。

支持: Claude Codex Code(CC)
🥉 75 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“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实例发现歧义,然后在最终发布前解决这些问题。

安全审计

安全
v1 • 2/24/2026

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.

1
已扫描文件
381
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
100
规范符合性

你能构建什么

技术规范编写

工程师可以使用此工作流程系统地捕获需求、探索备选方案,并生成 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阶段提供充分的上下文,以便在后续阶段获得更好的指导
  • 使用读者测试反馈来识别真正的差距,而不是维护现有内容
  • 每次改进一个部分,而不是进行广泛的改写
  • 忽视读者测试反馈,因为内容对作者来说似乎很明显

避免

  • 跳过上下文收集直接跳到起草会导致文档不完整
  • 进行广泛的改写而不是精细的逐部分完善
  • 忽视读者测试反馈,因为内容对作者来说似乎很明显

常见问题

完整工作流程需要多长时间?
完整的三个阶段工作流程通常需要30-60分钟处理实质性文档。您可以在各阶段之间暂停并稍后继续。对于较短的文档,流程可能需要15-20分钟。
我需要回答每个澄清问题吗?
不,您可以使用简写回复,跳过不适用的问题,或指出上下文已提供的时间。问题是指导,不是要求。回答有助于推动文档进展的内容。
我可以在没有Claude Code文件编辑功能的情况下使用此工作流程吗?
是的。工作流程适应没有文件编辑的环境,通过处理共享文档或让您复制输出进行工作。读者测试可以通过打开新的Claude对话手动完成。
哪种类型的文档最适合这种方法?
此工作流程非常适合技术规范、设计文档、决策记录、RFC和提案等实质性文档。对于快速笔记或简单文档,自由形式的方法可能更高效。
如果我赶时间,可以跳过阶段吗?
没有子代理的情况下,您可以手动测试:在claude.ai打开新的Claude对话,粘贴您的文档,并提出预测的读者问题。报告新的Claude做对了什么或错了什么。

开发者详情

文件结构

📄 SKILL.md