关于 human-writing
Human Writing 是一项用于撰写或修改面向读者的散文文本的 Skill。它引导写作者选择模式、应用写作原则、去除常见 AI 写作痕迹,并检查成稿。
主要功能
- 01选择写作模式和目标读者
- 02应用散文写作原则
- 03撰写和修改文本
- 04去除常见 AI 写作痕迹
- 05按清单检查草稿
适用场景
- 01撰写项目介绍
- 02修改技术文档中的散文内容
- 03编辑 README 或仓库介绍
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ timlai666/ skills --skill human-writing安装后在 Claude Code 中输入/human-writing确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/ai-writing-patterns.mdfinal-checklist.mdhuman-writing-examples.mdhuman-writing-principles.mdmode-selection-and-language-rules.md详细介绍
人类写作
概述
无论是从头写作还是修改草稿,只要内容是给人阅读的,都使用此技能。目标是写出读者能够想象并付诸行动的文字,不留任何 AI 写作痕迹。
不要将其用于代码、JSON、SQL、shell 命令或其他结构化输出。如果其他技能负责格式或主题内容,请用该技能规划内容,并用此技能处理文字。
项目介绍、README 文件和仓库描述也使用此技能。在混合型技术文档中,对文字部分应用写作规则,同时确保命令、代码示例和 API 标识符准确无误。
此文件提供流程。具体规则见链接中的参考资料。请在每个步骤阅读对应的参考资料,而不要依赖记忆中的摘要。
工作流
-
选择模式。 阅读 references/mode-selection-and-language-rules.md。 在
rewrite和generate之间做出选择,确定读者和目的,匹配语言,并选择grounded或voiced。 -
学习原则和示例。 阅读 references/human-writing-principles.md,然后在起草前完整阅读 references/human-writing-examples.md。仔细研究示例如何将规则转化为自然的句子,包括那些改写后仍让读者需要自行推断太多内容的例子。
-
撰写草稿。 应用这些原则,以及示例中关于具体细节、读者背景、结构、词汇、节奏、语气和标点的做法。
-
消除 AI 写作模式。 阅读 references/ai-writing-patterns.md。在不改变含义、事实或意图的前提下,删除其中列出的所有模式。
-
检查完成稿。 阅读 references/final-checklist.md。逐项对照实际文本进行检查,修正不符合之处,然后再次检查。
-
汇报进行中的任务进度。 对于任何进行中的任务,每轮结束时都要在对话回复中附上一条简短的进度条,而不是放在交付内容中。以最初目标为基准:显示已验证完成项数/约定总项数、当前工作,以及完成前的剩余事项。单独显示待验收事项。除非明确调整了范围,否则保持分母不变;总数未知时,显示里程碑,不要编造百分比或完成日期。只有在所有约定的完成条件和交付条件均已满足时,才能显示 100%。