mcpField
I
interactive-writing-assistant

interactive-writing-assistant

github.com/jykim创意与媒体5059 次安装5 周前更新
代码仓库

关于 interactive-writing-assistant

interactive-writing-assistant 是覆盖构思到修订的协作写作技能。它让提纲与正文保持同步,可处理语音输入,并提供利用关联知识库和风格指南的工作流程。

主要功能

  1. 01同步维护提纲与正文
  2. 02处理语音转录内容
  3. 03扩展提纲并撰写段落
  4. 04润色草稿并审视论点
  5. 05使用知识库材料和风格指南

适用场景

  1. 01同步推进提纲和正文
  2. 02整理并润色语音转录稿
  3. 03将草稿与现有笔记关联
  4. 04检查文章脉络与论述

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jykim/claude-obsidian-skills --skill interactive-writing-assistant

安装后在 Claude Code 中输入/interactive-writing-assistant确认已加载。

详细介绍

交互式写作助手

概述

此技能通过与用户互动协作,支持写作过程的所有阶段。核心原则是共同发展大纲和正文(大纲与正文协同演进),在保持高层结构与详细内容同步的同时,充分利用用户的知识库。

核心原则

大纲与正文协同演进(COP)

为任何作品共同发展大纲和正文,使整体构思(通过大纲)与细节(正文)一并演进,同时保持两者同步。

格式结构:

## Section Title
%%
- Outline point 1
- Outline point 2
%%

Detailed prose goes here...

COP 指南:

  • 如果收到的内容只有大纲(或正文),则补全另一部分
  • 更新大纲时,也要更新对应的正文(反之亦然)
  • 将正文紧接在其大纲下方(绝不分开)
基于语音的用户输入(VUI)

用户输入可能通过语音界面传入,其中包含需要解析后再执行的命令和内容。

VUI 示例:

Let's continue writing:
    [content to be processed via IVT]

Let's improve this:
1. Remove all references of XYZ from writing
2. Change the style to the like of Haruki

VUI 处理:

  • 从内容中解析命令
  • 使用改进语音转录(IVT)提示词处理语音内容
  • 在 Markdown 或 HTML 注释(%% %%)中查找用户评论
  • 处理评论后,将其标记为 RESOLVED
互联且持续更新的文档(CLD)

每篇作品都是 PKM 系统的一部分,并与其他知识笔记相互关联。在整个写作过程中,尤其是在以下环节中,充分利用这些丰富的信息与知识(INK):

  • 构思助手(IDH)
  • 大纲扩展器(OEX)
  • 反方论证(DAV)

收到新的 INK 后,及时更新最终文档。

风格参考

根据请求采用特定的写作风格。你可以在 references/ 文件夹中创建风格指南:

  • 风格指南描述语气、词汇和句式偏好
  • 用户要求特定风格时,加载相应的风格指南

写作流程提示词

构思助手(IDH)

目的: 从知识库中查找并添加相关内容,丰富当前草稿。

流程:

  1. 在 Journal 文件夹中搜索相关经历
  2. 在 Reading/Articles 文件夹中搜索相关读物
  3. 在 Topics 文件夹中搜索相关主题
  4. 以 Markdown 引用块(>)插入查找结果

用法: 用户需要灵感,或想将草稿与已有知识联系起来时使用。


大纲扩展器(OEX)

目的: 丰富并改进大纲,为写作做好准备。

流程:

  1. 补全逻辑缺漏,使内容衔接自然
  2. 尽可能以 Wiki 链接的形式从知识库中提取相关内容
  3. 需要时,提出改进建议

用法: 写正文前强化大纲,或大纲显得不完整时使用。


改进语音转录(IVT)

目的: 处理并改进语音转录内容。

流程:

  1. 修正语法或转录错误
    • 删除多余或重复的换行
  2. 添加章节(大约每页一章)
    • 使用三级标题(###)
  3. 添加格式
    • 添加列表(项目符号列表/编号列表)
    • 突出显示适合保存到摘要中的引述
    • 内容精简,只保留精华(每章突出一处)
  4. 其他情况下保留现有正文
    • 总长度应与原文一致

用法: 用于语音录制内容,或需要整理和润色的粗略转录稿。


段落撰写器(PRW)

目的: 根据大纲撰写段落。

流程:

  1. 尽可能沿用大纲中的表达
    • 原样纳入非项目符号句子
    • 原样纳入大纲中的链接
  2. 添加新内容时,说明添加了什么以及原因
  3. 提到风格时,从 references/ 加载并使用相应的风格指南

重要事项:

  • 将段落放在大纲正下方(COP 原则)
  • 始终直接将内容添加到文档中,绝不要把内容粘贴到聊天中

用法: 将大纲扩展为完整正文,或用户要求根据大纲写作时使用。


草稿润色(DEN)

目的: 提升草稿的整体质量和流畅度。

流程:

  1. 检查整体行文和衔接
  2. 在章节和段落层面重新平衡内容
    • 理想情况下,每个段落的长度应大致相同(章节开头和结尾除外)
  3. 修正明显的语法错误或可疑的事实
  4. 避免大幅修改(改动越多,审阅者需要付出的精力越多)

用法: 当草稿已完成,但需要润色和完善时使用。


反方视角(DAV)

目的: 提供建设性的批评和其他视角。

流程:

  1. 批判主要论点
  2. 提供其他观点
  3. 检查事实和语法
  4. 提出其他改进建议

默认行为: 在文档中以评论形式添加建议(除非用户另有要求)。

用法: 当草稿需要批判性审阅,或用户希望强化论点时使用。


使用新知识更新文档(UDN)

目的: 根据新信息保持已发布内容的时效性。

流程:

  1. 收集自上次发布以来的相关 INK
  2. 提议更新原文
  3. 进行编辑,使内容保持最新

用法: 当重新审阅先前发布的内容,或已获取大量新知识时使用。


翻译

目的: 将文本自然地翻译成目标语言。

流程:

  1. 修正生硬的译文表达
  2. 使用自然、亲切的语气
  3. 灵活变换句尾表达,使行文流畅
  4. 标记在文化上显得生硬的内容

用法: 当用户需要以自然、亲切的语气进行翻译时使用。

操作指南

互动方式
  • 写作是一项高度互动的任务——应频繁征求反馈
  • 根据要求,将提示词应用于整篇文章或其中一部分
  • 将内容直接更新到目标笔记中(除非另有要求)
文件管理
  • 直接处理用户的文档
  • 为引用内容保持正确的 Wiki 链接格式
  • 在增强内容的同时保留现有文档结构
知识整合
  • 主动在用户的知识库中搜索相关内容
  • 通过 Wiki 链接建立恰当的关联
  • 保留出处信息和来源追踪
风格一致性
  • 用户指定特定风格时,加载相应的参考指南
  • 在全文中一致地运用风格原则
  • 在用户要求的风格与其真实表达方式之间取得平衡

快速参考

缩写:

  • IDH - 构思助手
  • OEX - 大纲扩展器
  • IVT - 改进语音转录稿
  • PRW - 段落撰写器
  • DEN - 草稿润色
  • DAV - 反方视角
  • UDN - 使用新知识更新文档

关键概念:

  • COP - 共同演进的大纲与正文
  • VUI - 基于语音的用户输入
  • CLD - 互联且持续发展的文档
  • INK - 信息与知识(来自 PKM 系统)

实施说明

调用时,判断用户需要写作流程中的哪个阶段的帮助,并应用相应的提示词。可根据用户需求按顺序应用多个提示词。始终遵循 COP 原则,并利用用户的知识库创建丰富且互相关联的内容。

评论

支持 Markdown