关于 llm-writing
llm-writing 是一项指导写作过程的 Agent 技能,适用于撰写文档、提示词、提交信息等文本。它强调先明确读者与内容范围,再依据资料起草并逐层修订。
主要功能
- 01写作前明确读者与范围
- 02查阅相关来源材料
- 03按内容节拍组织草稿
- 04从整体结构逐层修订
- 05删去冗余和无依据表述
适用场景
- 01撰写面向后续读者的文档
- 02起草提示词、PR 和提交信息
- 03修订长篇内容的信息层次
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ haowjy/ creative-writing-skills --skill llm-writing安装后在 Claude Code 中输入/llm-writing确认已加载。
详细介绍
LLM 写作
如果尚未加载,请加载 /creative-writing-skills:intent-modeling。
当篇幅超出简短回答时,请加载 /creative-writing-skills:information-hierarchy。
有意为之地写作
开始撰写文稿前:
- 明确范围。 谁会阅读这篇文稿,又会在什么时候阅读?能够留存到对话结束之后的文本(文件、提示词、文档、提交消息、PR)会被不在场的人阅读:不了解上下文的 Agent、队友,或已经忘记提问内容的人。为这些读者写作。读者开始阅读时知道什么,读完后应该知道什么?他们不需要知道什么?动笔前,把文稿拆分为若干段落要点:每个要点都是读者阅读过程中的一步,承载一个观点、目的或转折。
- 依据事实。 写作前检查相关的源材料、参考资料或笔记,并确保它们彼此一致。
- 起草。 先在可修改的地方写完整篇文稿,再交给读者:写文件时就在文件里写,否则就用草稿文件或工作笔记。直接把文本发到聊天、PR 或提交消息中,就没有修改机会。
- 修订。 先审视整篇文稿,再逐步深入:结构、要点、段落、句子、词语。每个层面都要问:这段文字在做什么?内容是否正确,是否承接前文,读者是否需要这些内容?删除或改写任何没有作用或不能帮助读者理解、掌握所需信息的内容。在不同层面之间来回检查:局部修改后,退回去审视它所在的要点、更大的结构和整篇文稿;修改应当仍然连贯,节奏也应有所变化。检查信息披露层级:答案仍应放在前面,深入内容不能提前出现,来源应放在末尾。
删除什么
- 为了填满现有章节而写的内容。删除它,或将内容合并到合适的位置。
- 只给概念贴标签,却不解释其运作方式。解释机制,或者删掉标签。
- 没有证据支撑的结论。展示证据,或者删掉主张。
- 用笃定的措辞掩盖不确定性。坦言你不知道的内容。
- 用限定语弱化每项主张(“值得注意的是”“需要考虑的是”)。直说,或者不说。
- 给指令附加条件(“仅在……时”“除非……”“如有需要”“当你认为已准备好时”)。大多数情况都是在回避明确表态。直接说明指令;只有在不满足条件时指令就不适用,才保留条件。
- 换种说法重复已说过的内容,或在结尾总结正文(“总而言之”“总体来看”)。删掉。
- 用过渡词连接观点,而不是说明观点之间的关系(“此外”“而且”“另外”)。如果没有这些词,关系就不清楚,应重新组织内容。
- 将两个分句配对,其中一半已经表达了完整意思(“这不是 X,而是 Y”)。保留表达核心意思的部分。
- 对话痕迹:写得像是在回应产生这段文字的对话。包括在对话中创造的术语、规则背后的事件、“旧版本”“如前所述”,以及回答读者从未提出的问题。读者并不在场。应为读者写作,并说明他们无需依赖对话也能核实的理由。
评论
支持 Markdown