edit-article

edit-article 技能概览

edit-article 是做什么的

edit-article 技能用于把已有的文章草稿重构成更清晰、层次更合理的成稿。它主要不是一个内容生成器，而是一套编辑工作流，目标是提升结构、衔接和可读性，而且比泛泛而谈的提示词更少靠猜。

谁适合使用它

如果你已经有草稿，并且希望把它修改到适合发布、交付客户或内部审阅的程度，就适合用 edit-article。它很适合技术写作者、编辑，以及需要可复用的 edit-article 指南、而不是一次性重写请求的团队。

它的不同之处

这个技能强调“按章节思考”：先梳理文章标题，再按依赖关系逐节修改，最后确认结构再动笔重写。这样的流程让 edit-article for Technical Writing 尤其适合后文依赖前文概念的文章。

如何使用 edit-article 技能

安装 edit-article

使用 npx skills add mattpocock/skills --skill edit-article 安装该技能。安装完成后，先打开技能文件，弄清楚编辑顺序，再去发起重写请求。

先阅读正确的文件

从 SKILL.md 开始看起。在这个仓库里，SKILL.md 是 edit-article 用法的主要权威来源，因为这里没有需要额外对照的脚本、规则或参考目录。也就是说，安装决策其实很简单：这个技能很轻量，但你需要自己提供文章内容和编辑目标。

给模型一份可执行的简报

想要更好的结果，请同时提供草稿、目标成品、受众和约束条件。一个高质量的提示可以是：“请帮我编辑这篇文章，让表达更清晰、衔接更顺畅，保持技术术语准确，保留所有论点，并收紧各节之间的过渡。” 如果你想把 edit-article 用在 Technical Writing 场景下，也可以明确说明优先级是准确性、简洁性，还是读者上手。

采用先章节、后正文的工作流

实用的 edit-article 工作流是：先贴出文章，让模型先给你章节结构图，确认顺序后，再按章节逐段重写。这样能减少过度改写，也更容易让模型保留依赖逻辑；当文章在讲流程、论证或实现路径时，这一点尤其重要。

edit-article 技能常见问题

edit-article 比普通提示词更好吗？

通常是更好，前提是草稿本身有明确结构，而且你在意保留原意。普通提示词也能改写文本，但 edit-article 多了一套更清晰的编辑方法：章节规划、依赖关系感知和可控修订。对于多段落文章，它比快速润色更合适。

什么时候不该用 edit-article？

如果你需要的是从零开始的选题创意、重度 SEO 策略，或者完整的内容 brief，就不该用它。它最适合修改已经存在的文章。如果草稿只有一两段，使用更简单的编辑提示词通常会更快。

它适合新手吗？

适合，只要你能提供草稿和明确目标。新手最常见的错误，是只说“帮我改好一点”，却不说明“更好”具体指什么。edit-article 最好用的方式，是把受众、重写力度，以及哪些部分绝对不能改清楚。

它能融入更大的写作工作流吗？

可以。它很适合技术写作或编辑工作流：前面的步骤负责大纲或事实收集，edit-article 负责精修。如果你已经在用审阅批注、风格指南或 release notes，这个技能可以帮你把粗稿打磨成更干净的终稿。

如何改进 edit-article 技能

提供更强的源材料

edit-article 的效果很大程度上取决于你给它的草稿质量。请提供标题、事实依据，以及任何必须保留的表述。如果某一段本来就弱，直接说明原因：“这个引言太泛了”，或者“这一步流程需要更清楚地体现因果关系。” 这样技能才能抓住明确的编辑目标。

明确编辑优先级

告诉模型什么最重要：保留语气、压缩长度、增强过渡、简化术语，还是提高精确度。对 edit-article 来说，优先级顺序很关键，因为同一段文字可以有不同的优化方向，而互相冲突的目标往往会带来混杂结果。

注意常见失败模式

最常见的失败模式，是重写后读起来很顺，但文章逻辑被改了。另一种是压缩过度，重要的细微差别被删掉。要避免这两种问题，最好先让模型给出章节计划，再在批准完整重写之前先检查它提议的结构。

在第一轮之后继续迭代

如果第一版已经接近目标，但还不够理想，就针对性修改，不要直接整篇重来。比如可以说：“保留结构，但把例子写得更具体一点”，或者“保留原意，但把每段再缩短约 20%。” 这通常是提升 edit-article 效果最快的方法，而且不会把已经改好的内容一起弄丢。