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 檔案，先理解編修順序，再提出改寫需求。

先讀對的檔案

先從 SKILL.md 看起。在這個 repository 裡，這個檔案是 edit-article 用法的主要事實來源，因為沒有其他需要一起比對的支援腳本、規則或參考資料夾。也就是說，安裝判斷很單純：這個技能很輕量，但你需要自己提供文章內容與編輯目標。

提供模型可用的簡報

要得到最好結果，請同時提供草稿、目標成果、受眾與限制。好的提示詞會像這樣：“Edit this article for clarity and flow, keep the technical terms accurate, preserve all claims, and tighten section transitions.” 如果你想用 edit-article for Technical Writing，就要說明重點是準確性、精簡，還是讀者導入。

採用先看章節的工作流程

實際可行的 edit-article 工作流程是：先貼上文章，請模型先畫出章節架構，確認順序，再逐章要求改寫。這樣可以減少過度編修，也能幫模型保留相依邏輯；當文章在說明流程、論證或實作路徑時，這一點尤其重要。

edit-article 技能 FAQ

edit-article 比一般提示詞更好嗎？

通常是，前提是草稿本身有明確結構，而且你在意保留原意。一般提示詞也能改寫文字，但 edit-article 多了更清楚的編輯方法：章節規劃、相依關係意識，以及受控修訂。對多段落文章來說，它比快速潤飾更合適。

什麼情況下不該用 edit-article？

如果你需要從零發想、重度 SEO 策略，或完整內容簡報，就不適合用它。它最適合拿來修訂已經存在的文章。如果草稿只有一兩段，較簡單的編修提示詞可能更快。

這個技能適合新手嗎？

可以，只要你能提供草稿和清楚目標。新手最常犯的錯，是只說「幫我寫得更好」，卻沒有定義「更好」是什麼。edit-article 最有效的用法，是先講清楚受眾、改寫幅度，以及哪些章節不能改動。

它能納入更大的寫作流程嗎？

可以。它很適合技術寫作或編輯流程：先由其他步驟負責大綱或事實蒐集，再由 edit-article 負責精修。如果你本來就有審稿註解、風格指南或 release notes 之類的材料，這個技能可以把粗稿轉成更乾淨的定稿。

如何提升 edit-article 技能

提供更好的原始素材

edit-article 的品質很大程度取決於你提供的草稿。請包含標題、來源事實，以及任何一定要保留的措辭。如果某段特別弱，也要說明原因，例如：“This intro is too broad,” 或 “This process step needs clearer cause and effect.” 這樣能讓技能有明確的編修目標。

明確指出編輯優先順序

告訴模型什麼最重要：保留語氣、縮短篇幅、改善銜接、簡化術語，或提升精準度。對 edit-article 來說，優先順序很重要，因為同一段文字可以朝不同方向優化，而彼此衝突的目標常會讓結果混雜。

留意常見失敗模式

最常見的失敗模式，是改寫後雖然流暢，卻改掉了文章的邏輯。另一種是壓縮過頭，讓重要的細節消失。要避免這兩種情況，可以先要求章節規劃，再在核准完整改寫前，先檢查提議的結構。

在第一輪後繼續迭代

如果第一版已經接近，但還不到定稿，請針對局部再修，不要整篇重來。比如：“Keep the structure, but make the examples more concrete,” 或 “Preserve meaning, but shorten each paragraph by about 20%.” 這通常是提升 edit-article 結果、同時不失去已經做好的好修改的最快方式。