关于 interactive-writing-assistant
interactive-writing-assistant 是覆盖构思到修订的协作写作技能。它让提纲与正文保持同步,可处理语音输入,并提供利用关联知识库和风格指南的工作流程。
主要功能
- 01同步维护提纲与正文
- 02处理语音转录内容
- 03扩展提纲并撰写段落
- 04润色草稿并审视论点
- 05使用知识库材料和风格指南
适用场景
- 01同步推进提纲和正文
- 02整理并润色语音转录稿
- 03将草稿与现有笔记关联
- 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)
目的: 从知识库中查找并添加相关内容,丰富当前草稿。
流程:
- 在 Journal 文件夹中搜索相关经历
- 在 Reading/Articles 文件夹中搜索相关读物
- 在 Topics 文件夹中搜索相关主题
- 以 Markdown 引用块(>)插入查找结果
用法: 用户需要灵感,或想将草稿与已有知识联系起来时使用。
大纲扩展器(OEX)
目的: 丰富并改进大纲,为写作做好准备。
流程:
- 补全逻辑缺漏,使内容衔接自然
- 尽可能以 Wiki 链接的形式从知识库中提取相关内容
- 需要时,提出改进建议
用法: 写正文前强化大纲,或大纲显得不完整时使用。
改进语音转录(IVT)
目的: 处理并改进语音转录内容。
流程:
- 修正语法或转录错误
- 删除多余或重复的换行
- 添加章节(大约每页一章)
- 使用三级标题(###)
- 添加格式
- 添加列表(项目符号列表/编号列表)
- 突出显示适合保存到摘要中的引述
- 内容精简,只保留精华(每章突出一处)
- 其他情况下保留现有正文
- 总长度应与原文一致
用法: 用于语音录制内容,或需要整理和润色的粗略转录稿。
段落撰写器(PRW)
目的: 根据大纲撰写段落。
流程:
- 尽可能沿用大纲中的表达
- 原样纳入非项目符号句子
- 原样纳入大纲中的链接
- 添加新内容时,说明添加了什么以及原因
- 提到风格时,从
references/加载并使用相应的风格指南
重要事项:
- 将段落放在大纲正下方(COP 原则)
- 始终直接将内容添加到文档中,绝不要把内容粘贴到聊天中
用法: 将大纲扩展为完整正文,或用户要求根据大纲写作时使用。
草稿润色(DEN)
目的: 提升草稿的整体质量和流畅度。
流程:
- 检查整体行文和衔接
- 在章节和段落层面重新平衡内容
- 理想情况下,每个段落的长度应大致相同(章节开头和结尾除外)
- 修正明显的语法错误或可疑的事实
- 避免大幅修改(改动越多,审阅者需要付出的精力越多)
用法: 当草稿已完成,但需要润色和完善时使用。
反方视角(DAV)
目的: 提供建设性的批评和其他视角。
流程:
- 批判主要论点
- 提供其他观点
- 检查事实和语法
- 提出其他改进建议
默认行为: 在文档中以评论形式添加建议(除非用户另有要求)。
用法: 当草稿需要批判性审阅,或用户希望强化论点时使用。
使用新知识更新文档(UDN)
目的: 根据新信息保持已发布内容的时效性。
流程:
- 收集自上次发布以来的相关 INK
- 提议更新原文
- 进行编辑,使内容保持最新
用法: 当重新审阅先前发布的内容,或已获取大量新知识时使用。
翻译
目的: 将文本自然地翻译成目标语言。
流程:
- 修正生硬的译文表达
- 使用自然、亲切的语气
- 灵活变换句尾表达,使行文流畅
- 标记在文化上显得生硬的内容
用法: 当用户需要以自然、亲切的语气进行翻译时使用。
操作指南
互动方式
- 写作是一项高度互动的任务——应频繁征求反馈
- 根据要求,将提示词应用于整篇文章或其中一部分
- 将内容直接更新到目标笔记中(除非另有要求)
文件管理
- 直接处理用户的文档
- 为引用内容保持正确的 Wiki 链接格式
- 在增强内容的同时保留现有文档结构
知识整合
- 主动在用户的知识库中搜索相关内容
- 通过 Wiki 链接建立恰当的关联
- 保留出处信息和来源追踪
风格一致性
- 用户指定特定风格时,加载相应的参考指南
- 在全文中一致地运用风格原则
- 在用户要求的风格与其真实表达方式之间取得平衡
快速参考
缩写:
- IDH - 构思助手
- OEX - 大纲扩展器
- IVT - 改进语音转录稿
- PRW - 段落撰写器
- DEN - 草稿润色
- DAV - 反方视角
- UDN - 使用新知识更新文档
关键概念:
- COP - 共同演进的大纲与正文
- VUI - 基于语音的用户输入
- CLD - 互联且持续发展的文档
- INK - 信息与知识(来自 PKM 系统)
实施说明
调用时,判断用户需要写作流程中的哪个阶段的帮助,并应用相应的提示词。可根据用户需求按顺序应用多个提示词。始终遵循 COP 原则,并利用用户的知识库创建丰富且互相关联的内容。