Agent skill

doc-coauthoring

Guide users through a structured workflow for co-authoring documentation, articles, or long-form content. Use when user wants to write documentation, proposals, articles, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting articles, or using "co-authoring" workflow.

Stars 129
Forks 41

Install this agent skill to your Project

npx add-skill https://github.com/zephyrwang6/myskill/tree/main/doc-coauthoring

SKILL.md

Doc Co-Authoring Workflow

协作式文档创作工作流。三个阶段:Context Gathering → Refinement & Structure → Reader Testing。

When to Offer This Workflow

触发条件:

  • 用户提到写文章、写文档、co-authoring
  • 用户提供素材并要求创作内容

简短说明流程后直接开始,不要过度解释。

Stage 1: Context Gathering

目标: 快速获取足够上下文,包括内容方向和写作风格。

元信息(必问)

  1. 文档类型?(公众号/小红书/技术文档/提案)
  2. 目标读者?
  3. 读完后的预期效果?
  4. 你的个人观点/角度?
  5. 篇幅和风格?

写作风格偏好(必问)

关键:提前确认风格,避免后续反复修改。

询问用户:

  • 有参考资料吗?(如有,先分析其风格并遵循)
  • 偏简洁还是详细?
  • 有什么写作习惯需要遵守?

参考资料风格分析

如果用户提供了参考资料:

先读取并分析其写作风格:

  • 句式特点(短句为主?长句为主?)
  • 结构方式(有无小标题?段落长度?)
  • 语气(口语化?正式?)
  • 避免的模式

分析完成后告知用户:"参考资料风格已学习,后续写作会遵循。"

常见写作反模式(默认避免)

除非用户明确要求,否则避免:

  1. 自问自答句式:❌ "这意味着什么?它意味着..." → ✅ 直接陈述
  2. 过度对比:❌ "不是...而是..." 连用多次 → ✅ 直接说是什么
  3. 小标题分割案例:❌ 每个案例都加粗标题 → ✅ 合并流畅叙述
  4. 设问开头:❌ "为什么会这样?" → ✅ 直接说原因
  5. 重复总结:❌ "总之、综上所述、这意味着" → ✅ 省略或精简
  6. 过度解释:❌ 每个概念都展开说明 → ✅ 假设读者有基础

用户说"太啰嗦"时,立刻精简,不要解释。

素材处理

如果用户提供了素材文件:

  • 直接读取
  • 提取关键信息
  • 不要过度询问,直接进入下一阶段

如果需要补充信息:

  • 可以搜索互联网获取热门观点、案例、数据
  • 主动搜索,不要每次都问"要不要搜索"

退出条件

用户回答完元信息问题后,直接进入 Stage 2,不要反复确认。

Stage 2: Refinement & Structure

目标: 逐章节头脑风暴、筛选、撰写、迭代。

确定结构

根据文档类型建议 3-6 个章节,创建文件框架(Markdown 文件),用 [待撰写] 占位。

每章节流程

Step 1: 头脑风暴

列出 8-15 个可能包含的点,编号呈现。

**N 个可能包含的点:**
1. xxx
2. xxx
...

**保留哪些?** 比如:`1、3、5、7`

Step 2: 筛选

用户回复选择后:

  • 如果用户说"全部"或"1-N":直接全部采用,不再确认
  • 如果用户选择部分:只用选中的
  • 不要追问"确定吗",直接进入撰写

Step 3: 撰写

根据筛选结果撰写该章节,直接更新文件。

撰写完成后:

  • 展示该章节内容(引用块格式)
  • 简短询问:"有想改的吗?没问题就「继续」"

Step 4: 迭代

用户反馈处理规则:

用户说 行动
"继续" 进入下一章节
"太啰嗦" 立刻精简,不解释
"不要xxx句式" 记住,后续章节也遵守
具体修改意见 执行修改,展示结果

迭代要快。 用户给反馈后立刻改,改完立刻展示,不要长篇解释。

风格学习

在迭代过程中记住用户的风格偏好:

  • 用户删掉了什么 → 后续避免
  • 用户说"太啰嗦" → 后续更精简
  • 用户说"不要自问自答" → 所有章节都避免

完成所有章节后

输出全文供用户通读,询问是否需要调整。

Stage 3: Reader Testing(可选)

目标: 用新鲜视角检查文档是否清晰。

仅当用户要求时执行,或文档较长/较复杂时建议。

执行方式

  1. 预测读者可能的问题(5-10 个)
  2. 用 sub-agent 或建议用户开新对话测试
  3. 发现问题则回到 Stage 2 修复

核心原则

效率优先

  • 不要反复确认,用户说了就执行
  • 头脑风暴后用户选"全部"就直接用
  • 迭代要快,改完就展示

风格一致

  • 第一章确定的风格,后续章节都遵守
  • 用户的修改反馈要记住,举一反三

精简表达

  • 展示内容用引用块,简洁
  • 过渡语一句话:"继续?" "有想改的吗?"
  • 不要长篇解释流程

常见反馈的快速响应

用户说 立刻做
"太啰嗦" 精简 50%,不解释
"不要自问自答" 重写,去掉所有设问句
"合并起来写" 去掉小标题,流畅叙述
"继续" 下一章节
"输出全文" 读取文件,完整展示

Expand your agent's capabilities with these related and highly-rated skills.

zephyrwang6/myskill

start-work

每日工作启动助手。读取Obsidian收件箱、计划文件,提醒今日待办,询问内容创作计划,展示周计划进度,调用热点采集。触发词:"开始工作"、"开启新一天"、"今天做什么"。帮助用户快速进入高效工作状态。

129 41
Explore
zephyrwang6/myskill

mem-query

AI个人记忆系统的记忆查询功能。检索各层级记忆文件,综合多层级信息回答用户问题。使用场景:(1) 用户问"我的记忆中关于XXX"时;(2) 用户询问自己的习惯/偏好/价值观时;(3) 需要基于用户历史提供建议时。该skill会自动检索L1-L4各层级,引用来源,给出基于记忆的个性化回答。

129 41
Explore
zephyrwang6/myskill

article-review

根据原文内容撰写深度文章评价/解读。当用户提供一篇文章、博客、公众号文章或任何长文内容,并要求生成评价、解读、读后感或二次创作内容时使用此技能。适用于:(1) 对技术文章、行业分析、年终总结等进行深度解读,(2) 提炼文章核心观点并用通俗语言重新表达,(3) 为社交媒体传播生成二次内容。

129 41
Explore
zephyrwang6/myskill

mem-record

AI个人记忆系统的记忆记录功能。自动从对话中提炼关键信息并记录到相应层级。使用场景:(1) 用户说"记录到记忆系统"、"记住这个"、"把这次对话记下来"时;(2) 检测到重要事件、决策、偏好表达时;(3) 用户完成重要任务或做出决策时。该skill会自动判断应该记录到L1情境层、L2行为层、L3认知层,还是建议更新L4核心层。

129 41
Explore
zephyrwang6/myskill

remotion-video

使用 Remotion 框架以编程方式创建视频。Remotion 让你用 React 组件定义视频内容,支持动画、字幕、音乐可视化、3D 视频、教程讲解视频等。适用于程序化视频、批量生成、数据驱动视频、音乐可视化、自动字幕等场景。

129 41
Explore
zephyrwang6/myskill

baoyu-post-to-x

Posts content and articles to X (Twitter). Supports regular posts with images/videos and X Articles (long-form Markdown). Uses real Chrome with CDP to bypass anti-automation. Use when user asks to "post to X", "tweet", "publish to Twitter", or "share on X".

129 41
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results