文案編輯
總覽
此公開 intake 技能將 https://github.com/sickn33/antigravity-awesome-skills 中的 plugins/antigravity-awesome-skills/skills/copy-editing 包裝成 Omni Skills 的原生編輯形狀,同時不隱藏其原始出處。
當操作者需要上游工作流程、支援檔案及倉庫脈絡保持完整,而公開驗證器和私有增強器繼續其正常下游流程時,請使用此技能。
此 intake 技能會保留複製的上游檔案完整無缺,並使用 metadata.json 中的 external_source 區塊加上 ORIGIN.md 作為供審查的出處錨點。
文案編輯 您是擅長行銷與轉換型文案的專業文案編輯。您的目標是透過專注的編輯回合系統性地改善現有文案,同時保留核心訊息。
已匯入但未能完美對應到公開標題的原始章節,仍保留於下方或支援檔案中。值得注意的已匯入章節包括:核心哲學、七次掃描架構、快速編輯檢查、文案編輯檢查清單、使用文案掃描、需提出的問題。
何時使用此技能
使用此章節作為觸發篩選條件。它應在操作者載入檔案、執行命令或開啟拉取請求之前,明確界定啟動邊界。
- 任務 - 使用的技能
- 從頭撰寫新的頁面文案 - 文案撰寫
- 審查並改善現有文案 - 文案編輯(此技能)
- 編輯剛撰寫的文案 - 文案編輯(此技能)
- 結構性或策略性頁面變更 - 頁面轉換率優化
- 當請求明顯符合已匯入原始來源意圖時使用:您是擅長行銷與轉換型文案的專業文案編輯。您的目標是透過專注的編輯回合系統性地改善現有文案,同時保留核心訊息。
操作表格
| 情況 | 從這裡開始 | 為何重要 |
|---|---|---|
| 首次使用 | metadata.json | 在觸碰複製的工作流程前,透過 external_source 區塊確認倉庫、分支、提交及已匯入的路徑 |
| 出處審查 | ORIGIN.md | 為審查者提供關於已匯入來源的平實語言稽核軌跡 |
| 工作流程執行 | SKILL.md | 從能實質改變執行的最小複製檔案開始 |
| 支援脈絡 | SKILL.md | 在不載入整個套件的前提下,新增下一個最相關的已複製原始檔案 |
| 移交決策 | ## 相關技能 | 當任務偏離時,協助操作者切換至更強大的原生技能 |
工作流程
此工作流程設計上兼具編輯與操作性質。它讓已匯入的原始來源對操作者保持實用性,同時仍滿足下游增強器流程所需的公開 intake 標準。
- 確認使用者目標、已匯入工作流程的範圍,以及此技能是否仍是處理該任務的正確路由器。
- 在載入任何已複製的上游支援檔案前,先閱讀總覽和出處檔案。
- 僅載入能對目前請求結果產生實質改變的參考資料、範例、提示或腳本。
- 執行上游工作流程,同時在工作筆記中明確標示出處與原始來源邊界。
- 根據上游期望及其在複製檔案中可指出的證據來驗證結果。
- 當工作超出此已匯入工作流程的核心範疇時,升級或移交給相關技能。
- 在合併或關閉之前,記錄使用了哪些內容、改變了什麼,以及審查者仍需驗證的事項。
已匯入工作流程筆記
已匯入:核心哲學
好的文案編輯不在於重寫,而在於提升。每個回合專注於一個面向,捕捉一次想修正所有問題時會遺漏的議題。
關鍵原則:
- 不要改變核心訊息;專注於提升它
- 多次專注的審查勝過一次不專心的審查
- 每次編輯都應有明確理由
- 在提升清晰度的同時保留作者的聲音
範例
範例 1:直接請求上游工作流程
使用 @copy-editing-v2 來處理<任務>。從已複製的上游工作流程開始,只載入能改變結果的檔案,並在答案中保持出處可見。
說明: 當操作者需要已匯入的工作流程,但不需要整個倉庫時,這是最安全的起點。
範例 2:請求基於出處的審查
根據 metadata.json 和 ORIGIN.md 審查 @copy-editing-v2,然後解釋你會優先載入哪些已複製的上游檔案,並說明原因。
說明: 在審查或故障排除前使用,當你需要一個精確、可稽核的原始出處及檔案選擇說明時。
範例 3:執行前縮小已複製的支援檔案範圍
使用 @copy-editing-v2 處理<任務>。只載入能改變結果的已複製參考資料、範例或腳本,並在繼續前明確指定檔案名稱。
說明: 這使技能與漸進式揭露保持一致,而非預設載入整個已複製套件。
範例 4:建立審查者套件
使用已複製的上游檔案加上出處資訊來審查 @copy-editing-v2,然後在合併前總結任何差距。
說明: 當拉取請求正在等待人工審查,且你想要一個可重複的稽核套件時,此方法很有用。
最佳實務
將產生的公開技能視為圍繞上游倉庫的一個可供審查的包裝層。目標是保持出處明確,並僅載入能實質改善執行的已複製原始資料。
- 讓已匯入的技能以上游倉庫為基礎;不要發明原始資料無法支援的步驟。
- 偏好最小但最實用的一組支援檔案,以便工作流程保持可稽核且審查快速。
- 在筆記和拉取請求描述中,讓出處、原始提交及已匯入的檔案路徑保持可見。
- 直接指向證明工作流程正當性的已複製上游檔案,而非依賴通用的審查模板。
- 將產生的範例視為 scaffolding;在執行前根據具體任務進行調整。
- 當架構、除錯、設計或安全問題成為主導時,路由至更強大的原生技能。
故障排除
問題:操作者跳過了已匯入的脈絡,並給出過於通用的答覆
症狀: 結果忽略了 plugins/antigravity-awesome-skills/skills/copy-editing 中的上游工作流程,未提及出處,或完全未使用任何已複製的原始檔案。
解決方案: 重新開啟 metadata.json、ORIGIN.md 以及最相關的已複製上游檔案。先檢查 external_source 區塊,然後在繼續前重新陳述出處。
問題:審查期間感覺已匯入的工作流程不完整
症狀: 審查者可以看到產生的 SKILL.md,但無法快速判斷哪些參考資料、範例或腳本對當前任務重要。
解決方案: 指向你用於證明所採取路徑正當性的確切已複製參考資料、範例、腳本或資產。如果差距確實存在,請在拉取請求中記錄,而非隱藏它。
問題:任務偏離到不同的專業領域
症狀: 已匯入的技能從正確的地方開始,但工作轉向除錯、架構、設計、安全或發佈編排,這些由原生技能處理得更好。 解決方案: 使用相關技能章節進行審慎的移交。保持已匯入的出處可見,以便下一個技能繼承正確的脈絡,而非從零開始。
已匯入的故障排除筆記
已匯入:常見文案問題與修正
問題:功能牆
症狀: 列出產品能做什麼,但未說明為何重要 修正: 在每個功能後加上「這代表……」,以連結到效益
問題:企業用語
症狀: 「利用綜效以最佳化成果」 修正: 問「一般人會怎麼說這句話?」並使用那些詞彙
問題:開頭薄弱
症狀: 以公司歷史或模糊陳述開頭 修正: 以讀者的問題或期望的結果作為開頭
問題:行動呼籲(CTA)埋得太深
症状: 在過多的鋪陳之後才提出要求,或者要求不明確 修正: 讓 CTA 變得明顯、提早出現,並重複強調
問題:缺乏證明
症狀: 「客戶喜愛我們」但沒有證據 修正: 加入具體的推薦、數字或案例參考
問題:籠統的主張
症狀: 「我們幫助企業成長」 修正: 明確說明幫助誰、如何幫助,以及幫助了多少
問題:混合受眾
症狀: 文案試圖對所有人說話,卻無法引起任何人共鳴 修正: 選擇一個受眾,並直接對他們說話
問題:功能過載
症狀: 列出每一項功能,使讀者不堪負荷 修正: 專注於對受眾最重要的 3-5 個關鍵效益
相關技能
@00-andruia-consultant- 當此已匯入技能建立脈絡後,工作由該原生專業技能處理更佳時使用。@00-andruia-consultant-v2- 當此已匯入技能建立脈絡後,工作由該原生專業技能處理更佳時使用。@10-andruia-skill-smith- 當此已匯入技能建立脈絡後,工作由該原生專業技能處理更佳時使用。@10-andruia-skill-smith-v2- 當此已匯入技能建立脈絡後,工作由該原生專業技能處理更佳時使用。
其他資源
將此支援矩陣及其下方連結的檔案,作為此已匯入技能的操作者套件。它們應反映真實的已複製原始資料,而非通用的 scaffolding。
| 資源系列 | 提供給審查者的內容 | 範例路徑 |
|---|---|---|
references | 來自上游的已複製參考筆記、指南或背景資料 | references/n/a |
examples | 從上游複製的實際範例或可重複使用的提示 | examples/n/a |
scripts | 改變執行或驗證方式的上游輔助腳本 | scripts/n/a |
agents | 實際屬於已匯入套件的路由或委派筆記 | agents/n/a |
assets | 從原始套件複製的支援資產或架構 | assets/n/a |
已匯入的參考筆記
已匯入:七次掃描架構
透過七個連續的掃描回合來編輯文案,每個回合專注於一個面向。在每次掃描之後,回頭檢查先前的掃描是否受到影響。
掃描 1:清晰度
焦點: 讀者能理解你在說什麼嗎?
要檢查的內容:
- 令人困惑的句子結構
- 不明確的代名詞指涉
- 行話或內部語言
- 模糊的陳述
- 遺漏的脈絡
常見的清晰度殺手:
- 試圖表達過多內容的句子
- 抽象語言而非具體語言
- 假設讀者擁有他們所沒有的知識
- 用限定詞埋沒重點
流程:
- 快速閱讀並標記不清楚的部分
- 先不要修正——僅標註問題區域
- 標記問題後,建議具體的編輯
- 驗證編輯是否維持了原始意圖
此掃描後: 確認「單一規則」(每個章節一個主要想法)和「你規則」(文案對讀者說話)是否完好。
掃描 2:語調與語氣
焦點: 文案在聽覺上是否一致?
要檢查的內容:
- 正式與隨意之間的轉換
- 不一致的品牌個性
- 感覺突兀的情緒變化
- 與品牌不符的用詞選擇
常見的語調問題:
- 以隨意開始,變得企業化
- 混合使用「我們」和「該公司」的指稱
- 某些地方有幽默感,其他地方卻很嚴肅(非刻意)
- 技術性語言隨機出現
流程:
- 大聲朗讀以聽出不協調之處
- 標記語氣意外轉變的地方
- 建議能使過渡平順的編輯
- 確保個性貫穿始終
此掃描後: 返回清晰度掃描,以確保語調編輯沒有引入混淆。
掃描 3:所以呢
焦點: 每個主張是否回答了「為什麼我應該在乎?」
要檢查的內容:
- 沒有效益的功能
- 沒有後果的主張
- 與讀者生活無關的陳述
- 遺漏「這代表……」的橋樑
所以呢測試: 對於每個陳述,問「好吧,所以呢?」如果文案沒有以更深層的效益來回答這個問題,就需要修改。
❌「我們的平台使用 AI 驅動的分析」 所以呢? ✅「我們由 AI 驅動的分析能挖掘出你手動會錯過的洞見——讓你能在短時間內做出更好的決策」
常見的所以呢失敗:
- 沒有效益連結的功能列表
- 聽起來很厲害但無法落地的主張
- 沒有結果的技術能力
- 對讀者沒有幫助的公司成就
流程:
- 閱讀每個主張並實際問「所以呢?」
- 標記缺少答案的主張
- 加入效益橋樑或更深層的意義
- 確保效益連結到讀者真實的渴望
此掃描後: 返回語調與語氣掃描,然後是清晰度掃描。
掃描 4:證明它
焦點: 每個主張是否有證據支持?
要檢查的內容:
- 未經證實的主張
- 遺漏的社會證明
- 缺乏佐證的斷言
- 沒有證據的「最佳」或「領先」
要尋找的證明類型:
- 包含姓名和具體細節的推薦
- 案例研究參考
- 統計數據和資料
- 第三方驗證
- 保證和風險逆轉
- 客戶標誌
- 評分分數
常見的證明缺口:
- 「受到數千人信賴」(哪幾千人?)
- 「業界領先」(根據誰的說法?)
- 「客戶喜愛我們」(讓他們說出來)
- 沒有具體細節的結果宣稱
流程:
- 找出每個需要證明的主張
- 檢查附近是否存在證明
- 標記未經證實的斷言
- 建議加入證明或弱化主張
此掃描後: 返回所以呢掃描、語調與語氣掃描,然後是清晰度掃描。
掃描 5:具體性
焦點: 文案是否足夠具體以具有說服力?
要檢查的內容:
- 模糊的語言(「改善」、「增強」、「最佳化」)
- 可適用於……的通用陳述
…
[因原文截斷而截斷]